diff --git a/agora-bridge.md b/agora-bridge.md
index dda6d9160..9ccbeafa1 100644
--- a/agora-bridge.md
+++ b/agora-bridge.md
@@ -3,6 +3,8 @@
 - A [[project]].
 - [[github]] [[go]] github.com/flancian/agora-bridge
   - Eventually a collection of [[bots]], [[bridges]], [[siphons]] that allows the [[agora]] to interact with other [[social networks]] and the [[fediverse]] -- and for those to become [[agora]] clients in turn.
+  - Bridges are configured with [[yaml]].
+    - [[yaml]] can be volunteered with your [[digital garden]].
 - [[contains]]
   - [[pull]] [[agora bot]] -- bot implementations for [[twitter]] and [[mastodon]].
   - Code to enable users to directly interact with social networks of choice (in the directions social network -> agora and agora -> social network).
@@ -35,13 +37,16 @@
 [siphons]: siphons "Siphons"
 [agora]: agora "Agora"
 [fediverse]: fediverse "Fediverse"
+[yaml]: yaml "Yaml"
 [pull]: pull "Pull"
 [agora bot]: agora-bot "Agora Bot"
-[Twitter]: twitter "Twitter"
-[Mastodon]: mastodon "Mastodon"
-[done]: done "DONE"
+[twitter]: twitter "Twitter"
+[mastodon]: mastodon "Mastodon"
+[done]: done "done"
 [agora bridge]: agora-bridge "Agora Bridge"
 [toot cli]: toot-cli "Toot Cli"
+[Mastodon]: mastodon "Mastodon"
 [do]: do "Do"
 [push]: push "Push"
+[Twitter]: twitter "Twitter"
 [//end]: # "Autogenerated link references"
\ No newline at end of file
diff --git a/agora-design.md b/agora-design.md
index 22ecb8f56..d396a317e 100644
--- a/agora-design.md
+++ b/agora-design.md
@@ -2,11 +2,16 @@
 
 - a [[design]]
   - [[go]] https://social.coop/web/statuses/105929339151612533
+    - the [[agora]] has three parts:
+      - the [[agora]] proper, a high level description of an intent in the form of a [[contract]] and instructions contained in a git repository.
+      - [[agora server]]
+      - [[agora bridge]]
 - [[pull]] [[agora]]
 
 
 [//begin]: # "Autogenerated link references for markdown compatibility"
 [go]: go "Go"
-[pull]: pull "Pull"
 [agora]: agora "Agora"
+[contract]: contract "CONTRACT"
+[pull]: pull "Pull"
 [//end]: # "Autogenerated link references"
\ No newline at end of file