improve SETUP; tidy links and FIXME hints

1 files changed, 41 insertions, 5 deletions

diff --git a/SETUP.md b/SETUP.md
index 322fa80..0b239d4 100644
--- a/SETUP.md
+++ b/SETUP.md
@@ -1,14 +1,50 @@
 # Preparations for website editing
 
-You will need any [Micropub](https://indieweb.org/Micropub) client
-that supports adding and editing [article](https://indieweb.org/article) posts.
+As user of Example orga,
+you can setup any [Micropub] client
+and then add and edit [article] posts
+on Example orga website(s).
 
+[Micropub]: <https://www.w3.org/TR/micropub/>
+  "Micropub - open standard for simple web content editing"
 
-## Recommended client
+[article]: <https://www.w3.org/TR/micropub/#posting-files=>
+  "article - Micropub item containing html (e.g. a blog post)"
 
-[TODO]
+
+## Special strings
+
+NB! This documentation uses special strings
+which you may want to adapt for your local setup:
+
+micropubhost: micropub.example.org
+domain: example.org
+
+organisation: Example orga
+
+
+## Clients
+
+Example orga web content uses Micropub,
+that is accessed with any of several [Micropub clients].
+
+Recommended is to use the [Indigenous] client,
+available for desktop, Android and ios.
+
+You can use several clients at once.
+
+[Micropub clients]: <https://indieweb.org/Micropub/Clients>
+  "Overview of Micropub clients"
+
+[Indigenous]: <https://indigenous.marksuth.dev/>
+  "Indigenous - app to interact with Micropub and Microsub services"
 
 
 ## Access rights
 
-[TODO]
+Micropub handles access control using [IndieAuth].
+
+FIXME
+
+[IndieAuth]: <https://indieauth.net/>
+  "IndieAuth - decentralized identity protocol on top of OAuth 2.0"