diff --git a/agora pkg chapter.md b/agora pkg chapter.md index 4d13d98ed..9a8cb44e3 100644 --- a/agora pkg chapter.md +++ b/agora pkg chapter.md @@ -222,19 +222,15 @@ Agora RFCs might be of varying length and detail, spanning in length from that o ## [[Agora Actions]] -An Agora action is a hint left in some medium by a user of [[Agora Protocol]] for the Agora. The purpose of the hint (its nature) is defined by the action; in general, though, Agora actions can be seen as lightweight contracts between an Agora and its authors. Invocations of an action are interpreted as [[intents]]. +An [[Agora Action]] is a hint left in some medium by a user of [[Agora Protocol]] for the Agora. The purpose of the hint (its nature) is defined by the action; in general, though, Agora actions can be seen as lightweight contracts between an Agora and its authors. Invocations of an action are interpreted as [[intents]]. + +An [[Agora Action]] is hinted by default by #tagging or [[linking]] the name of the action in resources, optionally next to nodes and URLs which the action might take as parameters. The sections below should clarify this. ## [[Go links]] -#go is an [[Agora Action]] that - -Go links provide an interest base case to study in the field of provisioning and (pro socially) exploiting[^exploiting] a [[knowledge commons]]. Put simply, [[go links]] are named social bookmarks -- strings of text (usually slugged, but not necessarily) associated with URLs by users in a community of practice. - -[^exploiting]: TODO: there's probably a better term for this in [[Free, Fair and Alive]]. - -[[Go links]] are a [[cognitive tool]] which was developed in [[Silicon Valley]] corporations and has the potential to spread and provide utility at internet scale. As [[cognitive artifacts]] they have a meaningful [[complementary]] component, which makes them interesting as a case study of [[Agora RFCs]] regardless of primary utility of application. +#go is an [[Agora Action]] that designates URLs as canonical or highly ranked for nodes in which the action appears. As an [[Agora action]], the contract provided by Go links is as such: @@ -242,6 +238,12 @@ As an [[Agora action]], the contract provided by Go links is as such: - An example: - #go https://anagora.org - Means that the Agora nodes which the document I'm writing this on will be served at will, by default, provide a redirect to https://anagora.org when queried for go links. + +Go links provide an interesting base case to study in the field of provisioning and (pro socially) exploiting[^exploiting] a [[knowledge commons]]. Put simply, [[go links]] are named social bookmarks -- strings of text (usually slugged, but not necessarily) associated with URLs by users in a community of practice. + +[^exploiting]: TODO: there's probably a better term for this in [[Free, Fair and Alive]]. + +[[Go links]] are a [[cognitive tool]] which was developed in [[Silicon Valley]] corporations and has the potential to spread and provide utility at internet scale. As [[cognitive artifacts]] they have a meaningful [[complementary]] component, which makes them interesting as a case study of [[Agora RFCs]] regardless of primary utility of application. The primary utility of Go Links, regardless of implementation details, is high. In a [[go links]] rich environment, users can depend on other users to have defined [[canonical links]] for named [[entities]]; that is, collections of specially relevant resources to the terms at hand, as shared in a [[commons]]. @@ -254,7 +256,7 @@ The primary utility of Go Links, regardless of implementation details, is high. ## [[Pull]] -Pull is an Agora Action. +#pull is an Agora Action. ## [[Push]]