diff --git a/come.md b/come.md
index c1fed06e1..930b6ddd3 100644
--- a/come.md
+++ b/come.md
@@ -1,15 +1,4 @@
 # Come
 
-- An [[action]], [[agora action]].
-- The inverse of [[go]].
-  - When you add a block '[[come]] [[foo]]' to a resource, the Agora tries to [[go link]] ```go/foo``` to the URL of the resource in question.
+- Deprecated.
 
-
-[//begin]: # "Autogenerated link references for markdown compatibility"
-[action]: action "Action"
-[agora-action]: agora-action "Agora Action"
-[go]: go "Go"
-[come]: come "Come"
-[foo]: foo "Foo"
-[go-link]: go-link "Go Link"
-[//end]: # "Autogenerated link references"
\ No newline at end of file
diff --git a/pull.md b/pull.md
index ca94f105a..6235a7551 100644
--- a/pull.md
+++ b/pull.md
@@ -1,8 +1,12 @@
 # Pull
 
+
 - An [[action]].
+- The inverse of [[go]].
   - [[pull]] [[agora action]] makes sense both in [[action]] and here in pull.
-- Can be used to implement broadcast, synonims, interest.
+  - It 'pulls attention' from the node referenced to the current node.
+- Can be used to implement broadcast, synonims, canonical terms, interest signaling.
+  - Node [[united states]] may [[pull]] USA.
 - Can provide benefits on both sides; those of the node pulling and those of the node being pulled.
   - In the context of a [[digital garden]], pull links function as a sort of inverse of the [[go]] link. They are equivalent to visiting the parameter node ("USA") and adding a go link to it pointing to the current one ("United States").
   - Note that in the context of a social network like the [[Agora]] those benefits can get to have a real life effect on people and their work; "pulling attention" is related to [[ranking]].
@@ -10,9 +14,9 @@
 
 [//begin]: # "Autogenerated link references for markdown compatibility"
 [action]: action "Action"
+[go]: go "Go"
 [pull]: pull "Pull"
 [agora-action]: agora-action "Agora Action"
 [digital-garden]: digital-garden "Digital Garden"
-[go]: go "Go"
 [agora]: agora "Agora"
 [//end]: # "Autogenerated link references"
\ No newline at end of file