From 308ea58dd51e2440ff993e68f6dee13a2f383eb4 Mon Sep 17 00:00:00 2001
From: ErikHommel <erik.hommel@civicoop.org>
Date: Tue, 7 Jan 2020 15:01:48 +0100
Subject: [PATCH] wip documentation

---
 docs/basic-concept.md |  16 ++++++++++++++++
 images/init-form.png  | Bin 0 -> 23555 bytes
 2 files changed, 16 insertions(+)
 create mode 100644 images/init-form.png

diff --git a/docs/basic-concept.md b/docs/basic-concept.md
index da720a1..0e7a017 100644
--- a/docs/basic-concept.md
+++ b/docs/basic-concept.md
@@ -1,4 +1,20 @@
 # Basic Concept of the Form Processor Extension
 
+The **Form Processor** extension allows you to specify the data that will be processed with a form on your public website.
+In CiviCRM you specify what data you want to display on the form, if and what default values you want to load and what should happen with the data that is submitted with the form.
+
+For example: I want a form that allows me to enter my name and email address so I can sign up for the newsletter.
+You can specify all that in the **Form Processor** and also specify that a new contact should be created if one can not be found with the email address, and that the contact found or created should be added to the newsletter group in CiviCRM.
+
+In this chapter we will briefly discuss the forms and screens you need to go through if you are specifying a form with the **Form Processor**.
+
+!!! Note "Techie stuff"
+    On a technical level: the extension actually generates an API action for the FormProcessor API entity.
+
+## Form Processors Page
+
 Once you installed the **Form Processor** extension you will have an additional option in the **Administer>Automation>Form processors** option which will lead you the the first view of all the form processors in your installation.
 This will be empty if you just installed the extension.
+
+![Form Processors Page](/images/init-form.png)
+
diff --git a/images/init-form.png b/images/init-form.png
new file mode 100644
index 0000000000000000000000000000000000000000..10fa8585e60edb045f95210fc9891cf816ff2689
GIT binary patch
literal 23555
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
A%m4rY

literal 0
HcmV?d00001

-- 
GitLab