From 5d6d3a3c58de74a484fca060851266995d9b91f3 Mon Sep 17 00:00:00 2001
From: Flancian <0@flancia.org>
Date: Wed, 30 Dec 2020 01:36:12 +0100
Subject: [PATCH] Auto: misc.

---
 agora.md        | 12 +++++++++++-
 backlinks.md    |  9 +++++++--
 pulled-links.md | 10 ++++++++++
 pulled-nodes.md |  9 +++++++++
 4 files changed, 37 insertions(+), 3 deletions(-)
 create mode 100644 pulled-links.md
 create mode 100644 pulled-nodes.md

diff --git a/agora.md b/agora.md
index 57c3f962d..f01b239ef 100644
--- a/agora.md
+++ b/agora.md
@@ -1,6 +1,13 @@
 # Agora
 
 - [The Agora is a distributed knowledge graph and experimental social network](https://anagora.org/).
+  - As an Agora *reader* you can:
+    - Navigate the Agora, which is composed of nodes which aggregate content from many users on the same topic or entity.
+    - See [[backlinks]] and [[pulled nodes]].
+  - As an Agora *writer* you can:
+    - Have your content be surfaced to users at a relevant time (when they are visiting a related node).
+    - Use [[agora actions]].
+  - Note anyone can run an Agora of their own if they so desire. The Agora is [[open source]].
 - To participate in the Agora, you need some way to publish 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. 
   - If you know your way around [[git]], [[markdown]] on git is the default format. If you use [[roam]] or a [[roam like]], you're almost there. Please refer to [agora howto](https://anagora.org/go/agora-howto) for detailed 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 your content location and desired username.
@@ -19,10 +26,14 @@
 - [[pull]] [[agora editor]]
 
 [//begin]: # "Autogenerated link references for markdown compatibility"
+[backlinks]: backlinks "Backlinks"
+[agora actions]: agora-actions "Agora Actions"
+[open source]: open-source "Open Source"
 [markdown]: markdown "Markdown"
 [roam]: roam "Roam"
 [roam like]: roam-like "Roam Like"
 [maintainer]: maintainer "Maintainer"
+[integrated]: integrated "Integrated"
 [maximally inclusive]: maximally-inclusive "Maximally Inclusive"
 [agora twitter integration]: agora-twitter-integration "Agora Twitter Integration"
 [CONTRACT]: contract "CONTRACT"
@@ -36,7 +47,6 @@
 [internet citizen]: internet-citizen "Internet Citizen"
 [agora protocol]: agora-protocol "Agora Protocol"
 [flancia]: flancia "Flancia"
-[agora actions]: agora-actions "Agora Actions"
 [go]: go "Go"
 [pull]: pull "Pull"
 [agora editor]: agora-editor "Agora Editor"
diff --git a/backlinks.md b/backlinks.md
index 7f1bf8750..0923d57c3 100644
--- a/backlinks.md
+++ b/backlinks.md
@@ -1,10 +1,15 @@
 # Backlinks
 
 - A chunk of the power of [[roam likes]], the other being [[wikilinks]] (not exclusive to them) and [[block references]].
+- A backlink is any link *to* the page you're visiting.
+- Currently the [[agora]] surfaces backlinks from nodes in the same [[agora]]. In the future it will support sources such as other agoras ([[agora protocol]]) and social networks such as [[twitter]].
 
 
 [//begin]: # "Autogenerated link references for markdown compatibility"
-[roam-likes]: roam-likes "Roam Likes"
+[roam likes]: roam-likes "Roam Likes"
 [wikilinks]: wikilinks "Wikilinks"
-[block-references]: block-references "Block References"
+[block references]: block-references "Block References"
+[agora]: agora "Agora"
+[agora protocol]: agora-protocol "Agora Protocol"
+[twitter]: twitter "Twitter"
 [//end]: # "Autogenerated link references"
\ No newline at end of file
diff --git a/pulled-links.md b/pulled-links.md
new file mode 100644
index 000000000..057fae460
--- /dev/null
+++ b/pulled-links.md
@@ -0,0 +1,10 @@
+# Pulled Links
+
+- Nodes that are specially relevant to the context at hand can be *pulled*. To do this, just add a block using the [[pull]] action:
+  - [[pull]] [[pulled nodes]]
+
+
+[//begin]: # "Autogenerated link references for markdown compatibility"
+[pull]: pull "Pull"
+[pulled nodes]: pulled-nodes "Pulled Nodes"
+[//end]: # "Autogenerated link references"
\ No newline at end of file
diff --git a/pulled-nodes.md b/pulled-nodes.md
new file mode 100644
index 000000000..9573c70d2
--- /dev/null
+++ b/pulled-nodes.md
@@ -0,0 +1,9 @@
+# Pulled Nodes
+
+- [[pull]] [[pulled links]]
+- Currently pulls like the above only work when you are in precisely the context they are declared; that is, pulling is not recursive. This might change.
+
+[//begin]: # "Autogenerated link references for markdown compatibility"
+[pull]: pull "Pull"
+[pulled links]: pulled-links "Pulled Links"
+[//end]: # "Autogenerated link references"
\ No newline at end of file