diff --git a/agora.md b/agora.md index dccabf875..6d987b636 100644 --- a/agora.md +++ b/agora.md @@ -1,3 +1,5 @@ # Agora -- A knowledge base for all our problems and their likely solutions. -- In Flancia, of course, there is an Agora. \ No newline at end of file +- An Agora is, in its most basic form, a set of conventions. Users that follow the convention associated with an Agora are said to be *in* the Agora. +- Useful conventions are made explicit in an Agora's [[CONTRACT]]. +- An Agora is built around a distributed knowledge graph maintained by its users. +- In Flancia, of course, there is an Agora: https://flancia.org/agora. \ No newline at end of file diff --git a/wikilink.md b/wikilink.md index 2f7d54c0d..d5fbc7c08 100644 --- a/wikilink.md +++ b/wikilink.md @@ -1,6 +1,7 @@ # Wikilink - A wikilink looks like this: [[wikilink]]. +- Wikilinks are the heart of the [[Agora]]. - Wikilinks come, wait for it, from wikis :) You can think of the Agora as a sort of distributed wiki, although users in this wiki contribute individual contributions instead of community pages (for now). - Wikilinks are great because they allow for very easy linking: you just [[link it as you go along]], then the link either works (because someone wrote that node/article/resource already) or you can click through and backfill it. I call this procedure link-driven writing. - Whenever there is more than one [[node]] with a given wikilink in an Agora (typical use case: notes kept on a certain topic by different users), the Agora will surface all of them when resolving the wikilink in question. Example: [[README]]. @@ -8,5 +9,6 @@ [//begin]: # "Autogenerated link references for markdown compatibility" [wikilink]: wikilink "Wikilink" +[Agora]: agora "Agora" [link it as you go along]: link-it-as-you-go-along "Link It as You Go Along" [//end]: # "Autogenerated link references" \ No newline at end of file