on master help sign in
link to official CONTRIBUTING for in-depth info
commite01a18076e747f7d0975ff1295554d259486b012 authorTobias Merkle <tgamerkle@gmail.com> dateThu 16 Jun 2016, 11:33 (10 years ago) parent40dd757
2 files changed+14−18
docs/about/contributing.md+1−1 docs/arvo/web-apps.md+13−17
docs/about/contributing.md+1−1
@@ -13,7 +13,7 @@ for improving our [code](https://github.com/urbit/urbit/) and
1313
1414## Code guidelines
1515
16−Refer to [Hoon Syntax](/hoon/syntax) for an in-depth guide to good Hoon.
16+Our official guide to contributing can be found [here](https://github.com/urbit/urbit/blob/master/CONTRIBUTING.md), which is most useful for large and low-level changes. For simpler revisions, refer to [Hoon Syntax](/hoon/syntax) for an in-depth guide to good Hoon.
1717Alternatively, [browse the
1818source](https://github.com/urbit/arvo/blob/master/arvo/hoon.hoon).
1919
docs/arvo/web-apps.md+13−17
@@ -72,18 +72,16 @@ asserting the parsing succeeded with `need`, and asserting the
7272result was 'click' with `?>`, which asserts that its first child
7373is true.
7474
75−<blockquote class="blockquote">
76−Note the argument to `++json`is `jon/^json`. Why `^json`?
77−`++json` shadows the type definition, so if we want to refer to
78−the type, we have to prepend a `^`. This extends to multiple
79−levels: `^^^foo` means the fourth most innermost instance of `foo`.
80−
81−`++jo` in `zuse` is a useful library for parsing complex json
82−into hoon structures. In this case, the `:` between `so` and
83−`jo` means 'inside of', because `so` is an arm contained within
84−the core `jo`. Our case is actually simple enough that the
85−`?>` line could have been `?> =([%s 'click'] jon)`.
86−</blockquote>
75+> Note the argument to `++json`is `jon/^json`. Why `^json`?
76+> `++json` shadows the type definition, so if we want to refer to
77+> the type, we have to prepend a `^`. This extends to multiple
78+> levels: `^^^foo` means the fourth most innermost instance of `foo`.
79+
80+> `++jo` in `zuse` is a useful library for parsing complex json
81+> into hoon structures. In this case, the `:` between `so` and
82+> `jo` means 'inside of', because `so` is an arm contained within
83+> the core `jo`. Our case is actually simple enough that the
84+> `?>` line could have been `?> =([%s 'click'] jon)`.
8785
8886We can test this mark from the command line (don't forget to start your app with `|start %click`)
8987
@@ -115,11 +113,9 @@ And `/mar/clicks.hoon`:
115113`clicks` is just an atom. We convert to json by creating an
116114object with a single field "clicks" with our value.
117115
118−<blockquote class="blockquote">
119−Be sure to checkout section 3bD, JSON and XML, in zuse.hoon
120−`++joba` is just a function that takes a key-value pair and
121−produces a JSON object with one element.
122−</blockquote>
116+> Be sure to checkout section 3bD, JSON and XML, in zuse.hoon
117+> `++joba` is just a function that takes a key-value pair and
118+> produces a JSON object with one element.
123119
124120```
125121~fintud-macrep:dojo> &json &clicks 6