Default commit message, part of an automated flow.

agora editor.md

@@ -1,5 +1,9 @@
 # Agora Editor
 
+- To contribute to the [[Agora]], you need to write down notes or posts in one of the [[supported formats]] and upload your notes to a ***git repository*** of your choice. These steps are expanded below.
+  - Get a [[github]] account if you don't have a git host already: <https://github.com>.
+    - Install [[git]] if needed: <https://git-scm.com/download>. It should be installed by default in [[linux]], comes bundled with [[mac os]].
+  - See [[agora signup]] for more details on the process.
 - In a nutshell: you need to host your notes (more generally, [[resources]], defaulting to [[markdown]] plus [[wikilinks]]), somewhere online. And then let the [[agora]] know about it.
 	- The Agora doesn't host your data, but rather pulls it from a location *you* control and renders it for you and other users; in the process interlinking your data with that of other users.
 	- Most users currently host [[git]] repositories on https://github.com or https://gitlab.com. 

agora howto.md

@@ -1,18 +1,6 @@
 # Agora Howto
 
-- To [[read]] the Agora, you don't need anything but a [[web browser]].
-  - This [[Agora]] is fully browsable on <https://anagora.org>.
-  - You can add the Agora as a [[search engine]].
-- To [[contribute]] to the Agora, first you need to publish your [[digital garden]] or [[content]] elsewhere online. The Agora doesn't host your data, but rather pulls it from a location *you* control and renders it for you and other users; it interlinks it with that of other users.
-  - If you know your way around [[git]], [[markdown]] on git is the default format. If you use [[roam]] or a [[roam like]] or you have a notes database, you're almost there. 
-  - Whatever participation mechanism you choose, you need to let an Agora [[maintainer]] know where your content is, so it can be pulled and [[integrated]]. We strive to continuously support new sources and formats. Please send email to signup@anagora.org with:
-    - The URL for your content.
-    - Your desired username.
-  - The Agora wants to be [[maximally inclusive]], but it is in its infancy; it is a [[work in progress]]. If you want to participate and can't, please also send email to signup@anagora.org to let us know.
-  - Through projects such as [[agora twitter integration]], we hope to make the Agora available to anyone that has access to a social network account.
-- Please refer to [[agora install]] for detailed setup instructions and [[agora editor]] for alternative clients.
-  - [[pull]] [[agora editor]] [[agora install]]
-- [[go]] https://github.com/flancian/agora/blob/master/docs/howto.md
-
-
-
+- To join an Agora:
+  - [[pull]] [[agora signup]]
+- To run an Agora:
+  - [[pull]] [[agora install]]

agora install.md

@@ -1,15 +1,4 @@
 # Agora Install
 
-- To contribute to the [[Agora]], you need to write down notes or posts in [[Markdown format]] and upload your notes to a ***git repository*** of your choice. These steps are expanded below.
-  - Get a [[github]] account if you don't have a git host already: <https://github.com>.
-    - Install [[git]] if needed: <https://git-scm.com/download>. It should be installed by default in [[linux]], comes bundled with [[mac os]].
-  - If you don't have a [[personal knowledge management]] system of choice to manage your notes, we currently recommend [[obsidian]]. [[foam]] also works well.
-  - See [[agora editor]] for alternatives.
-- Then send email to signup@anagora.org or a Twitter DM to [[flancian]] with:
-  - The URL of your repo.
-  - Your desired username (can be distinct from that of your git host).
-  - Confirmation that you agree to the Agora's [[contract]] (only the one by the @agora user; other contracts are optional).
-- Non-git sources and formats other than [[Markdown]] will be supported in the future; if you store your notes using some other system, please reach out.
-- See also (needs updating): [agora howto](https://anagora.org/go/agora-howto).
-
-
+- a [[howto]].
+- These are instructions to [[run your own agora]]. If you are looking for instructions on how to *join* this agora, please refer to: [[agora editor]], [[agora signup]].

agora signup.md

@@ -0,0 +1,17 @@
+# agora signup
+
+- To [[read]] the Agora, you don't need anything but a [[web browser]].
+  - This [[Agora]] is fully browsable on <https://anagora.org>.
+  - You can add the Agora as a [[search engine]].
+- To [[contribute]] to the Agora, first you need to publish your [[digital garden]] or [[content]] elsewhere online. The Agora doesn't host your data, but rather pulls it from a location *you* control and renders it for you and other users; it interlinks it with that of other users.
+  - If you know your way around [[git]], [[markdown]] on git is the default format. If you use [[roam]] or a [[roam like]] or you have a notes database, you're almost there. 
+  - Whatever participation mechanism you choose, you need to let an Agora [[maintainer]] know where your content is, so it can be pulled and [[integrated]]. We strive to continuously support new sources and formats. 
+    - You can send email to signup@anagora.org or reach out to a member of [[flancia collective]] with:
+      - The URL of your repo or content.
+      - Your desired username.
+      - Confirmation that you agree to the Agora's [[contract]] (only the one by the @agora user; other contracts are optional).
+    - Alternatively if you know your way around [[git]] you can send a PR for `gardens.yaml` in the Agora repo: [[go/agora]].
+  - The Agora wants to be [[maximally inclusive]], but it is in its infancy; it is a [[work in progress]]. If you want to participate and can't, please also send email to signup@anagora.org to let us know.
+      - Non-git sources and formats other than [[Markdown]] will be supported in the future; if you store your notes using some other system, please reach out.
+      - Through projects such as [[agora twitter integration]], we hope to make the Agora available to anyone that has access to a social network account.
+- Please refer to [[agora install]] in case you want to run your own Agora; and to [[agora editor]] for more information on clients.

journal/2021-08-11.md

@@ -14,3 +14,5 @@
 - [[flow]]
   - fixed backup issue that was plaging thecla/filling up space
   - finally added agora-server and agora-bridge as systemd (user) services succesfully
+  - [[agora howto]]
+  - [[agora signup]]

supported formats.md

@@ -0,0 +1,8 @@
+# Supported formats
+
+- a [[list]].
+  - The [[Agora]] supports:
+    - [[plain text]]
+    - [[markdown]] (plus [[wikilinks]])
+    - [[org mode]] (in progress)
+