diff --git a/agora.md b/agora.md
index f01b239ef..11d930f88 100644
--- a/agora.md
+++ b/agora.md
@@ -5,8 +5,8 @@
     - 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]].
+    - Have your content be surfaced to users at relevant times (when they are visiting a node on a relevant topic or entity).
+    - Make use of [[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.
@@ -15,18 +15,21 @@
   - Through projects such as [[agora twitter integration]], we hope to make the Agora available to anyone that has access to a social network account.
 - An Agora is, in its most basic form, a set of useful conventions.
   - Useful conventions are made explicit through an Agora's [[CONTRACT]] and the writing of its users.
-  - The Agora is built around the notion of the [[wikilink]]: see [[wikilinks fanout]] and [[wikilinks everywhere]]. You can think of the Agora as a distributed [[wiki]] or an experiment in [[semantic web]] [[applications]] if you are so inclined.
+  - The Agora is built around the notion of the [[wikilink]]: see [[wikilinks fanout]] and [[wikilinks everywhere]]. 
+  - You can think of the Agora as a distributed [[wiki]] or an experiment in [[semantic web]] [[applications]] if you are so inclined.
   - An Agora is a [[distributed knowledge graph]] maintained by the users of an experimental [[social network]].
     - By [[you]] and [[me]]. Anyone can participate if they are willing.
-    - Check out [[agora plan]] if you are interested in the working implementation plan.
-- This Agora tries to be a good pro-social [[internet citizen]].
-  - [[see also]] [[agora protocol]], [[wikilinks everywhere]], [[agora twitter integration]], [[flancia]].
-  - [[agora actions]] try to give direct utility to users of the agora.
+    - Check out [[agora howto]] (users) or [[agora plan]] (developers) if you want to jump in.
+- This Agora tries to be a good [[internet citizen]].
+  - [[agora protocol]]
+    - [[wikilinks everywhere]]
+  - [[agora twitter integration]]
 - [[go]] github.com/flancian/agora
 - [[pull]] [[agora editor]]
 
 [//begin]: # "Autogenerated link references for markdown compatibility"
 [backlinks]: backlinks "Backlinks"
+[pulled nodes]: pulled-nodes "Pulled Nodes"
 [agora actions]: agora-actions "Agora Actions"
 [open source]: open-source "Open Source"
 [markdown]: markdown "Markdown"
@@ -43,10 +46,10 @@
 [distributed knowledge graph]: distributed-knowledge-graph "Distributed Knowledge Graph"
 [you]: you "You"
 [me]: me "Me"
+[agora howto]: agora-howto "Agora Howto"
 [agora plan]: agora-plan "Agora Plan"
 [internet citizen]: internet-citizen "Internet Citizen"
 [agora protocol]: agora-protocol "Agora Protocol"
-[flancia]: flancia "Flancia"
 [go]: go "Go"
 [pull]: pull "Pull"
 [agora editor]: agora-editor "Agora Editor"