git.iko.soy/urbit.org
on master help sign in
link to official CONTRIBUTING for in-depth info
e01a180Tobias Merkle
docs/about/contributing.md+1−1
compare with master
unifiedsplit
@@ -13,7 +13,7 @@ for improving our [code](https://github.com/urbit/urbit/) and
13
13
14## Code guidelines
14## Code guidelines
15
15
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.
17Alternatively, [browse the
17Alternatively, [browse the
18source](https://github.com/urbit/arvo/blob/master/arvo/hoon.hoon).
18source](https://github.com/urbit/arvo/blob/master/arvo/hoon.hoon).
19
19
docs/arvo/web-apps.md+13−17
@@ -72,18 +72,16 @@ asserting the parsing succeeded with `need`, and asserting the
72result was 'click' with `?>`, which asserts that its first child
72result was 'click' with `?>`, which asserts that its first child
73is true.
73is true.
74
74
75−<blockquote class="blockquote">
76−Note the argument to `++json`is `jon/^json`. Why `^json`?
75+> Note the argument to `++json`is `jon/^json`. Why `^json`?
77−`++json` shadows the type definition, so if we want to refer to
76+> `++json` shadows the type definition, so if we want to refer to
78−the type, we have to prepend a `^`. This extends to multiple
77+> the type, we have to prepend a `^`. This extends to multiple
79−levels: `^^^foo` means the fourth most innermost instance of `foo`.
78+> levels: `^^^foo` means the fourth most innermost instance of `foo`.
80−
79+
81−`++jo` in `zuse` is a useful library for parsing complex json
80+> `++jo` in `zuse` is a useful library for parsing complex json
82−into hoon structures. In this case, the `:` between `so` and
81+> into hoon structures. In this case, the `:` between `so` and
83−`jo` means 'inside of', because `so` is an arm contained within
82+> `jo` means 'inside of', because `so` is an arm contained within
84−the core `jo`. Our case is actually simple enough that the
83+> the core `jo`. Our case is actually simple enough that the
85−`?>` line could have been `?> =([%s 'click'] jon)`.
84+> `?>` line could have been `?> =([%s 'click'] jon)`.
86−</blockquote>
87
85
88We can test this mark from the command line (don't forget to start your app with `|start %click`)
86We can test this mark from the command line (don't forget to start your app with `|start %click`)
89
87
@@ -115,11 +113,9 @@ And `/mar/clicks.hoon`:
115`clicks` is just an atom. We convert to json by creating an
113`clicks` is just an atom. We convert to json by creating an
116object with a single field "clicks" with our value.
114object with a single field "clicks" with our value.
117
115
118−<blockquote class="blockquote">
119−Be sure to checkout section 3bD, JSON and XML, in zuse.hoon
116+> 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
117+> `++joba` is just a function that takes a key-value pair and
121−produces a JSON object with one element.
118+> produces a JSON object with one element.
122−</blockquote>
123
119
124```
120```
125~fintud-macrep:dojo> &json &clicks 6
121~fintud-macrep:dojo> &json &clicks 6