Auto: misc.

agora-editor.md

@@ -15,6 +15,7 @@
 [2020-12-29]: journal/2020-12-29 "2020-12-29"
 [foam]: foam "Foam"
 [vscode]: vscode "Vscode"
+[extension]: extension "Extension"
 [Agora]: agora "Agora"
 [maximally inclusive]: maximally-inclusive "Maximally Inclusive"
 [obsidian]: obsidian "Obsidian"

agora-howto.md

@@ -2,9 +2,8 @@
 
 - [[go]] https://github.com/flancian/agora/blob/master/docs/howto.md
   - (If you see nodes that have a block beginning with go, they refer to go links. anagora.org/go/node redirects to the URL in that line. Example: https://flancia.org/go/agora-howto).
-- [[todo]] Should be a high level walkthrough from zero to "you know how to navigate the Agora" and "you have a digital garden and you know how to integrate it into the Agora if you are willing".
 - To [[sign up]] for 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. Please refer to [agora howto](https://anagora.org/go/agora-howto) for detailed instructions.
+  - 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. Please refer to [[agora install]] for detailed setup instructions.
   - 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.

agora-install.md

@@ -1,9 +1,9 @@
 # Agora Install
 
-- Set up a [[personal knowledge management]] system for note taking and upload your notes in [[Markdown]] format to a git repository of your choice.
+- To contribute to the [[Agora]], you need to 1. write down notes or articles in [[Markdown format]] and 2. 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>.
-  - If you don't have a personal knowledge management system of choice, we recommend [[foam]]: <https://foambubble.github.io/foam/>. To use foam: 
+  - If you don't have a [[personal knowledge management]] system of choice to manage your notes, we currently recommend [[foam]]: <https://foambubble.github.io/foam/>. To use foam:
     - Fork its template repository: <https://github.com/foambubble/foam-template/>. You can use any name you desire for your repository.
     - Install [[vscode]] if necessary: <https://code.visualstudio.com/download>. Launch it.
     - Select 'clone repository' -- if you're using [[github]], log in with [[github]]. Authorize [[vscode]] to make changes to your account. It sometimes requires you to retry once for some reason.
@@ -18,18 +18,21 @@
       - You may need to set a user.name and user.email in git. To do this, open the terminal in [[vscode]] and type:
         - git config --global user.name "Your Name"
         - git config --global user.email "yourname@example.com"
-- Send email to signup@anagora.org or a Twitter DM to [[flancian]] with:
+- 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) 
 
 
 [//begin]: # "Autogenerated link references for markdown compatibility"
+[Agora]: agora "Agora"
 [personal knowledge management]: personal-knowledge-management "Personal Knowledge Management"
-[Markdown]: markdown "Markdown"
 [foam]: foam "Foam"
 [vscode]: vscode "Vscode"
 [wikilinks]: wikilinks "Wikilinks"
 [flancian]: flancian "Flancian"
 [contract]: contract "CONTRACT"
+[Markdown]: markdown "Markdown"
 [//end]: # "Autogenerated link references"

extension.md

@@ -0,0 +1,2 @@
+# Extension
+

personal-knowledge-management.md

@@ -1,6 +1,7 @@
 # Personal Knowledge Management
 
 - [[pull]] [[pkm]]
+- [[pull]] [[agora editor]]
 - See also [[distributed knowledge graph]].
 - See also [[roam-likes]]