From 03b581743b38af31e847446c2eac064f4107208a Mon Sep 17 00:00:00 2001
From: Jonas Smedegaard <dr@jones.dk>
Date: Sat, 23 Apr 2022 14:52:03 +0200
Subject: improve SETUP; tidy links and FIXME hints

---
 SETUP.md | 46 +++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 41 insertions(+), 5 deletions(-)

(limited to 'SETUP.md')

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"
-- 
cgit v1.2.3