@@ -45,7 +45,7 @@ Graph Store can be poked with a `graph-update`, which can:
4545
4646## Scries
4747
48−What follows is a summary of the scrys available in graph-store
48+What follows is a summary of the scries available in graph-store.
4949
5050<!-- enhancement: add examples -->
5151<!-- enhancement: add refrences to relevant sections in data structures explanation -->
@@ -53,28 +53,28 @@ What follows is a summary of the scrys available in graph-store
5353
5454### Export State
5555
56−Obtain a vase of the current state of graph-store as a noun
56+Obtain a vase of the current state of graph-store as a noun.
5757
5858* Path: `/x/export`
5959* Output Type: `network:store`
6060
6161### Fetch keys
6262
63−Fetch the resources of all graphs that graph-store is currently tracking
63+Fetch the resources of all graphs that graph-store is currently tracking.
6464
6565* Path: `/x/keys`
6666* Output Type: `(set resource)`
6767
6868### Fetch tag queries
6969
70−Fetch the available tag queries from graph-store
70+Fetch the available tag queries from graph-store.
7171
7272* Path: `/x/tag-queries`
7373* Output Type: `tag-queries`
7474
7575### Fetch tags
7676
77−Fetch all available tags from graph-store
77+Fetch all available tags from graph-store.
7878
7979* Path: `/x/tag-queries/tags`
8080* Output Type: `(list term)`
@@ -105,7 +105,7 @@ Fetch the time of the latest log entry by resource, if the update-log for the gi
105105* Inputs
106106 * **ship** (`ship`) - The ship of the resource.
107107 * **name** (`@tas`) - The name of the resource.
108− * **start** and **end** (`@da`) - all logs after **start** and before **end** are to be included in the result
108+ * **start** and **end** (`@da`) - All logs after **start** and before **end** are to be included in the result.
109109* Output Type: `update-log:store`
110110
111111### Fetch a specific graph by resource
@@ -134,12 +134,11 @@ Returns the mark associated a given graph, if one exists.
134134Returns a subset of nodes from a graph, with or without descendants, optionally filtering for ones that fall between the start and end indexes.
135135
136136* Path: `/x/graph/[ship]/[name]/subset/[mode]/[start?]/[end?]`
137−
138137* Inputs:
139138 * **ship** (`ship`) - The ship of the resource.
140139 * **name** (`@tas`) - The name of the resource.
141− * **mode** (`?(%kith %lone)`) - `%kith` to include descendants, `%lone` to exclude
142− * **start** and **end** (`(unit atom)`) - Atoms used to start and end the subset. If these are unable to be parsed, the subset will start at the smallest node
140+ * **mode** (`?(%kith %lone)`) - `%kith` to include descendants, `%lone` to exclude.
141+ * **start** and **end** (`(unit atom)`) - Atoms used to start and end the subset. If these are unable to be parsed, the subset will start at the smallest node.
143142* Output Type: `update:store` `%add-nodes`
144143
145144### Check if node exists
@@ -150,19 +149,19 @@ Returns a flag, `%.y` if the node exists and `%.n` otherwise.
150149* Inputs:
151150 * **ship** (`ship`) - The ship of the resource.
152151 * **name** (`@tas`) - The name of the resource.
153− * **[index+]** `(list atom)`- The index of the node to check. The index should be appended to the path as a list
152+ * **[index+]** `(list atom)`- The index of the node to check. The index should be appended to the path as a list.
154153* Output Type: `flag`
155154
156155### Request a node
157156
158−Returns an `%add-nodes` update containing the node that was requested
157+Returns an `%add-nodes` update containing the node that was requested.
159158
160159* Path: `/x/graph/[ship]/[name]/node/index/[mode]/[index+]`
161160* Inputs
162161 * **ship** (`ship`) - The ship of the resource.
163162 * **name** (`@tas`) - The name of the resource.
164163 * **mode** (`?(%kith %lone)`) - `%kith` to include descendants, `%lone` to exclude
165− * **[index+]** `(list atom)`- The index of the node being requested. The index should be appended to the path as a list
164+ * **[index+]** `(list atom)`- The index of the node being requested. The index should be appended to the path as a list.
166165* Output Type: `update:store` `%add-nodes`
167166
168167### Request a node's children
@@ -174,9 +173,9 @@ Returns a subset of a node's children, with or without descendants, optionally f
174173* Inputs
175174 * **ship** (`ship`) - The ship of the resource.
176175 * **name** (`@tas`) - The name of the resource.
177− * **mode** (`?(%kith %lone)`) - `%kith` to include descendants, `%lone` to exclude
178− * **start** and **end** (`(unit atom)`) - Atoms used to start and end the subset. If these are unable to be parsed, the subset will start at the smallest node
179− * **[index+]** `(list atom)`- The index of the node being requested. The index should be appended to the path as a list
176+ * **mode** (`?(%kith %lone)`) - `%kith` to include descendants, `%lone` to exclude.
177+ * **start** and **end** (`(unit atom)`) - Atoms used to start and end the subset. If these are unable to be parsed, the subset will start at the smallest node.
178+ * **[index+]** `(list atom)`- The index of the node being requested. The index should be appended to the path as a list.
180179
181180* Output Type: `update:store` `%add-nodes`
182181
@@ -190,13 +189,13 @@ Returns a subset of a node's children, with or without descendants, optionally f
190189 * **ship** (`ship`) - The ship of the resource.
191190 * **name** (`@tas`) - The name of the resource.
192191 * **direction** (`?(%older %newer %oldest %newest)`)-
193− + `%newer` - load the siblings with keys larger than the requested node
194− + `%older` - load the siblings with keys smaller than the requested node
195− + `%newest` - load the siblings with the largest keys
196− + `%oldest` - load the siblings with the largest keys
197− * **mode** (`?(%kith %lone)`) - `%kith` to include descendants, `%lone` to exclude
198− * **count** (`atom`) - a limit to the number of nodes to return
199− * **[index+]** `(list atom)`- The index of the node being requested. The index should be appended to the path as a list
192+ + `%newer` - Load the siblings with keys larger than the requested node.
193+ + `%older` - Load the siblings with keys smaller than the requested node.
194+ + `%newest` - Load the siblings with the largest keys.
195+ + `%oldest` - Load the siblings with the largest keys.
196+ * **mode** (`?(%kith %lone)`) - `%kith` to include descendants, `%lone` to exclude.
197+ * **count** (`atom`) - A limit to the number of nodes to return.
198+ * **[index+]** `(list atom)`- The index of the node being requested. The index should be appended to the path as a list.
200199* Output Type: `update:store` `%add-nodes`
201200
202201### Request a node's firstborn child
@@ -207,19 +206,18 @@ Returns a subset of a node's children, with or without descendants, optionally f
207206* Inputs:
208207 * **ship** (`ship`) - The ship of the resource.
209208 * **name** (`@tas`) - The name of the resource.
210− * **[index+]** `(list atom)`- The index of the node being requested. The index should be appended to the path as a list
209+ * **[index+]** `(list atom)`- The index of the node being requested. The index should be appended to the path as a list.
211210
212211* Output: `update:store` `%add-nodes`
213212
214213### Request nodes, depth first
215214
216215* Path: `/x/graph/[ship]/[name]/node/depth-first/[count]/[start]`
217−
218216* Input
219217 * **ship** (`ship`) - The ship of the resource.
220218 * **name** (`@tas`) - The name of the resource.
221− * **count** (`(unit atom)`) - a limit to the number of nodes to return
222− * **start** (`(unit atom)`) - the index fragment to start at
219+ * **count** (`(unit atom)`) - A limit to the number of nodes to return.
220+ * **start** (`(unit atom)`) - The index fragment to start at.
223221
224222* Output Type: `update:store` `%add-nodes`
225223
@@ -241,7 +239,7 @@ The following is the definition of the agent state, known as `network`.
241239Briefly,
242240- `graphs` represents all graphs that graph store is aware of an is storing data about.
243241- `tag-queries` is how graph store implements its tagging system, and uses it to keep track of associations between tags and the respective index.
244−- `update-logs` is where graph-store stores the update-log that backs each graph, keyed by resource <!-- refrence to advanced section talking about how this is the source of truth -->
245−- `archive` is where graph-store stores archived graphs. these are graphs which can no longer have updates run against them. <!-- this nuance should also be present in the advanced info -->
242+- `update-logs` is where graph-store stores the update-log that backs each graph, keyed by resource. <!-- refrence to advanced section talking about how this is the source of truth -->
243+- `archive` is where graph-store stores archived graphs. These are graphs which can no longer be updated through `%run-updates`. <!-- this nuance should/could also be present in the advanced info -->
246244
247245For more information on these types, please take a look at the [data structure overview](/docs/userspace/graph-store/data-structure-overview).