[taler-docs] 01/03: rework intro

[gnunet]

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository docs.

commit 1e36811c2e084704248c466b9927d29512b696d1
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Fri Nov 6 23:49:35 2020 +0100

    rework intro
---
 taler-merchant-api-tutorial.rst | 29 ++++++++++++++++++++---------
 1 file changed, 20 insertions(+), 9 deletions(-)

diff --git a/taler-merchant-api-tutorial.rst b/taler-merchant-api-tutorial.rst
index 39cf36d..7f371f0 100644
--- a/taler-merchant-api-tutorial.rst
+++ b/taler-merchant-api-tutorial.rst
@@ -40,8 +40,12 @@ regulation (such as GDPR).
 About this tutorial
 -------------------
 
-This tutorial addresses how to process payments using the GNU Taler
-merchant Backend. This chapter explains some basic concepts. In the
+This tutorial addresses how to process payments using the GNU Taler merchant
+Backend.  The audience for this tutorial are *developers* of merchants (such
+as Web shops) that are working on integrating GNU Taler with the
+customer-facing Frontend and the staff-facing Backoffice.
+
+This chapter explains some basic concepts. In the
 second chapter, you will learn how to do basic payments.
 
 This version of the tutorial has examples for Python3. It uses the
@@ -51,18 +55,23 @@ languages/environments are available as well.
 If you want to look at some simple, running examples, check out these:
 
 -  The `essay
-   merchant <https://git.taler.net/blog.git/tree/talerblog/blog/blog.py>`__
+   merchant 
<https://git.taler.net/taler-merchant-demos.git/tree/talermerchantdemos/blog>`__
    that sells single chapters of a book.
 
 -  The `donation
-   page 
<https://git.taler.net/donations.git/tree/talerdonations/donations/donations.py>`__
+   page 
<https://git.taler.net/taler-merchant-demos.git/tree/talermerchantdemos/donations>`__
    that accepts donations for software projects and gives donation
    receipts.
 
 -  The
-   `survey 
<https://git.taler.net/survey.git/tree/talersurvey/survey/survey.py>`__
+   `survey 
<https://git.taler.net/taler-merchant-demos.git/tree/talermerchantdemos/survey>`__
    that gives users who answer a question a small reward.
 
+-  The `WooCommerce plugin 
<https://git.taler.net/gnu-taler-payment-for-woocommerce.git/>`__
+   which is a comprehensive integration into a Web shop including the refund 
business
+   process.
+
+
 Architecture overview
 ---------------------
 
@@ -97,9 +106,11 @@ with the exchange, and also does not deal with sensitive 
data. In
 particular, the merchant’s signing keys and bank account information are
 encapsulated within the Taler backend.
 
-Some functionality of the backend (the “public interface“) is also
-exposed to the customer’s browser directly. In the HTTP API, all public
-endpoints are prefixed with ``/public/``.
+Some functionality of the backend (the “public interface“) is exposed to the
+customer’s browser directly. In the HTTP API, all private endpoints (for the
+Backoffice) are prefixed with ``/private/``.  This tutorial focuses on the
+``/private/`` endpoints. The public interface is directly used by the wallet
+and not relevant for the merchant (other than that the API must be exposed).
 
 
 .. index:: sandbox, authorization
@@ -108,7 +119,7 @@ Public Sandbox Backend and Authentication
 -----------------------------------------
 
 How the frontend authenticates to the Taler backend depends on the
-configuration. See Taler Merchant Operating Manual.
+configuration. See `GNU Taler Merchant Backend Operator Manual`.
 
 The public sandbox backend https://backend.demo.taler.net/ uses an API
 key in the ``Authorization`` header. The value of this header must be

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.