on master help sign in
Reorganize Urbytes and Community docs sections into single 'Learn' section.

What I like about this is that it allows multiple doc series to get actively developed at the same time in one section that clearly stands out as the section for contributors to fork and PR. I.e., Curtis has been busy lately so hasn’t really been able to get to the next Urbyte. But other docs have been written since then. With a single ‘Learn’ section (I can’t think of a better name — I think the clearness of the word trumps the potential blandness), people can know where to come back to if they’ve “graduated” from the existing material and see if anything new has been added. Basically, it takes less pressure off of us for managing our own in-house docs and groups them with all the docs that the community is feeling like writing themselves. I think that’s how this should be anyways. @galenwp, @cgyarvin, thoughts?

commit7a78fcb9972b5b2680ab21acf59499a9fa4d9a0e authorKeaton Dunsford <keaton@tlon.io> dateTue 14 Feb 2017, 10:36 (10 years ago) parent430c6c4
6 files changed+39−7
docs/learn.md+12 docs/learn/community.md+18 docs/byte.md → docs/learn/urbyte.md+3−1 docs/byte/0.md → docs/learn/urbyte/0.md+2−2 docs/byte/1.md → docs/learn/urbyte/1.md+3−3 docs/byte/2.md → docs/learn/urbyte/2.md+1−1
docs/learn.mdnew file+12
@@ -0,0 +1,12 @@
1+---
2+navhome: /docs/
3+sort: 2
4+---
5+
6+# Learn
7+
8+As a open-source project, writing documentation for Urbit has become a kind of rite of passage for aspiring contributors.
9+
10+Learn Hoon from the ground up through our in-house Urbyte series, or delve into the great doc efforts by some of our awesome community developers.
11+
12+<list/>
docs/learn/community.mdnew file+18
@@ -0,0 +1,18 @@
1+---
2+navhome: /docs/
3+next: true
4+title: Community docs
5+sort: 2
6+---
7+
8+# Community docs
9+
10+* The `~master-morzod`
11+[docs](http://micnus-tarwyl-haltem-linhut--dilhul-talbes-wolnyx-lasbud.urbit.org/docs/),
12+and [`fora`](https://urbit.org/fora/posts/~2016.12.25..06.35.44..a1ec~/) post.
13+
14+* The (formerly) `~hidduc-posmeg`
15+[docs](https://fosnut-dandut.urbit.org/pages/hidducs-notes/tutorial),
16+and [`fora`](https://urbit.org/fora/posts/~2017.2.12..21.54.40..6fde~/) post.
17+
18+* [Urbit by Doing](https://github.com/Fang-/Urbit-By-Doing), by `~palfun-foslup`.
docs/byte.md → docs/learn/urbyte.mdrenamed+3−1
@@ -1,6 +1,8 @@
11---
22navhome: /docs/
3−sort: 2
3+next: true
4+title: Urbytes
5+sort: 1
46---
57
68# Urbytes
docs/byte/0.md → docs/learn/urbyte/0.mdrenamed+2−2
@@ -5,7 +5,7 @@ next: true
55title: Setup and nouns
66---
77
8−# Urbyte 0: setup and nouns
8+# Urbyte 0: Setup and nouns
99
1010This is the first post in our new Urbyte series.
1111
@@ -109,7 +109,7 @@ $ ls -a /path/to/mycomet
109109./ ../ .urb/
110110```
111111
112−Restarting uses almost the same command, but without `-c` (which
112+Restarting uses almost the same command, but without `-c` (which
113113means "create"). There are also fewer startup messages:
114114
115115```
docs/byte/1.md → docs/learn/urbyte/1.mdrenamed+3−3
@@ -5,7 +5,7 @@ next: true
55title: Atoms, auras, types
66---
77
8−# Urbyte 1: atoms, auras, types
8+# Urbyte 1: Atoms, auras, types
99
1010Thanks for reading Urbyte 0! In Urbyte 1, we'll look a little
1111more deeply at atoms and other simple noun types.
@@ -41,7 +41,7 @@ string starting with `@`, like `@ud` for unsigned decimal.
4141Hoon has a wide (but not extensible) variety of atom syntaxes.
4242Each syntax for an atom produces an appropriate predefined aura.
4343And Hoon's printer can invertibly print any aura Hoon can parse.
44−Because atoms make great path nodes and paths make great URLs,
44+Because atoms make great path nodes and paths make great URLs,
4545all regular atom syntaxes use only URL-safe characters.
4646
4747## Examples
@@ -211,7 +211,7 @@ strings, which nothing in Hoon recognizes. The set of syntaxes
211211that Hoon knows how to parse and/or print is fixed. But there
212212are plenty of good reasons to use your own user-defined auras.
213213
214−If your program uses both fortnights and furlongs, Hoon will not
214+If your program uses both fortnights and furlongs, Hoon will not
215215parse a user-defined fortnight syntax. It will not print furlongs
216216in the dojo. But the type system will keep you from accidentally
217217passing a furlong to a function that expects a fortnight.
docs/byte/2.md → docs/learn/urbyte/2.mdrenamed+1−1
@@ -4,7 +4,7 @@ sort: 3
44title: Subject-oriented programming
55---
66
7−# Urbyte 2: subject-oriented programming
7+# Urbyte 2: Subject-oriented programming
88
99Thanks for reading Urbytes 0 and 1! In Urbyte 2, we'll take
1010nouns for granted and have some real fun with them.