git.iko.soy/urbit.org
on master help sign in
Reorganize Urbytes and Community docs sections into single 'Learn' section.
7a78fcbKeaton Dunsford
docs/learn.mdnew file+12
compare with master
unifiedsplit
@@ -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 @@
1---
1---
2navhome: /docs/
2navhome: /docs/
3+next: true
4+title: Urbytes
3−sort: 2
5+sort: 1
4---
6---
5
7
6# Urbytes
8# Urbytes
docs/byte/0.md → docs/learn/urbyte/0.mdrenamed+2−2
@@ -5,7 +5,7 @@ next: true
5title: Setup and nouns
5title: Setup and nouns
6---
6---
7
7
8−# Urbyte 0: setup and nouns
8+# Urbyte 0: Setup and nouns
9
9
10This is the first post in our new Urbyte series.
10This is the first post in our new Urbyte series.
11
11
@@ -109,7 +109,7 @@ $ ls -a /path/to/mycomet
109./ ../ .urb/
109./ ../ .urb/
110```
110```
111
111
112−Restarting uses almost the same command, but without `-c` (which
112+Restarting uses almost the same command, but without `-c` (which
113means "create"). There are also fewer startup messages:
113means "create"). There are also fewer startup messages:
114
114
115```
115```
docs/byte/1.md → docs/learn/urbyte/1.mdrenamed+3−3
@@ -5,7 +5,7 @@ next: true
5title: Atoms, auras, types
5title: Atoms, auras, types
6---
6---
7
7
8−# Urbyte 1: atoms, auras, types
8+# Urbyte 1: Atoms, auras, types
9
9
10Thanks for reading Urbyte 0! In Urbyte 1, we'll look a little
10Thanks for reading Urbyte 0! In Urbyte 1, we'll look a little
11more deeply at atoms and other simple noun types.
11more deeply at atoms and other simple noun types.
@@ -41,7 +41,7 @@ string starting with `@`, like `@ud` for unsigned decimal.
41Hoon has a wide (but not extensible) variety of atom syntaxes.
41Hoon has a wide (but not extensible) variety of atom syntaxes.
42Each syntax for an atom produces an appropriate predefined aura.
42Each syntax for an atom produces an appropriate predefined aura.
43And Hoon's printer can invertibly print any aura Hoon can parse.
43And 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,
45all regular atom syntaxes use only URL-safe characters.
45all regular atom syntaxes use only URL-safe characters.
46
46
47## Examples
47## Examples
@@ -211,7 +211,7 @@ strings, which nothing in Hoon recognizes. The set of syntaxes
211that Hoon knows how to parse and/or print is fixed. But there
211that Hoon knows how to parse and/or print is fixed. But there
212are plenty of good reasons to use your own user-defined auras.
212are plenty of good reasons to use your own user-defined auras.
213
213
214−If your program uses both fortnights and furlongs, Hoon will not
214+If your program uses both fortnights and furlongs, Hoon will not
215parse a user-defined fortnight syntax. It will not print furlongs
215parse a user-defined fortnight syntax. It will not print furlongs
216in the dojo. But the type system will keep you from accidentally
216in the dojo. But the type system will keep you from accidentally
217passing a furlong to a function that expects a fortnight.
217passing 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
4title: Subject-oriented programming
4title: Subject-oriented programming
5---
5---
6
6
7−# Urbyte 2: subject-oriented programming
7+# Urbyte 2: Subject-oriented programming
8
8
9Thanks for reading Urbytes 0 and 1! In Urbyte 2, we'll take
9Thanks for reading Urbytes 0 and 1! In Urbyte 2, we'll take
10nouns for granted and have some real fun with them.
10nouns for granted and have some real fun with them.