git.iko.soy/urbit.org
on master help sign in
more friendly
b7305c1Galen Wolfe-Pauly
docs.md+35−11
compare with master
unifiedsplit
@@ -10,21 +10,45 @@ sort: 4
10 <h1 class="blue i-b">Urbit docs</h1>
10 <h1 class="blue i-b">Urbit docs</h1>
11</div>
11</div>
12
12
13−Go to the [technical overview](about/overview) for a high-level
13+<div class="col-md-12 head">
14−architecture description. To install and run Urbit, read forward from the
15−[installation guide](using/install).
16
14
15+<div class="col-md-8">
16+
17+Check out the [technical overview](about/overview) for a high-level
18+architecture description. To install and run Urbit, head to the Using section, starting with the [installation guide](using/install) and continuing forward.
19+
17−To begin developing for Urbit, start by learning Hoon [syntax](hoon/syntax),
20+To begin developing for Urbit, start by learning Hoon [syntax](hoon/syntax),
18−then walk through the [Arvo tutorials](arvo). The examples and exercises
21+then walk through the [Arvo tutorials](arvo). The examples and exercises
19−in Arvo will teach you to build high-level programs and interact with the network.
22+in Arvo will teach you to build high-level programs and interact with the network.
20
23
21Dig into the mechanics of Urbit with [Core Hoon](hoon). Refer back
24Dig into the mechanics of Urbit with [Core Hoon](hoon). Refer back
22−there for pure-code exercises and functions in the [standard library](hoon/library).
25+there for pure-code exercises and functions in the [standard library](hoon/library).
26+
27+Registered academics are required to start with the [Nock definition](nock/definition) and work upward from there.
28+
29+</div>
30+
31+<div class="col-md-4">
23
32
24−Registered academics are required to start with the [Nock definition](nock/definition)
33+<b>Source on GitHub</b>
25−and work upward from there.
34+<ul>
26−<br/>
35+<li><a href="https://github.com/urbit/urbit">Main repo</a></li>
27−<br/>
36+<li><a href="https://github.com/urbit/examples">Examples</a></li>
37+<li><a href="https://github.com/urbit/docs">Documentation</a></li>
38+</ul>
39+
40+<b>Community / contact</b>
41+<ul>
42+<li>We use <code>:talk</code> on Urbit to chat.</li>
43+<li><a href="https://reddit.com/r/urbit">/r/urbit on Reddit</a></li>
44+<li><a href="https://twitter.com/urbit_">@urbit_ on Twitter</a></li>
45+<li><a href="https://groups.google.com/forum/#!forum/urbit-dev">urbit-dev mailing list</a></li>
46+<li><a href="mailto:urbit@urbit.org">urbit@urbit.org</a></li>
47+</ul>
48+
49+</div>
50+
51+</div>
28
52
29<div class="sections">
53<div class="sections">
30 <kids grid="true"></kids>
54 <kids grid="true"></kids>
docs/arvo.md+6−2
@@ -1,8 +1,12 @@
1---
1---
2navhome: /docs
2navhome: /docs
3−sort: 4
3+sort: 3
4---
4---
5
5
6−# Arvo
6+# Arvo programming
7+
8+This example-based sequence of tutorials shows you how to build simple programs in hoon and use the basic features of Arvo.
9+
10+If you like to learn by example, start here.
7
11
8<list/>
12<list/>
docs/hoon.md+6−2
@@ -1,8 +1,12 @@
1---
1---
2navhome: /docs
2navhome: /docs
3−sort: 3
3+sort: 4
4---
4---
5
5
6−# Hoon
6+# Hoon reference
7+
8+This in-depth reference covers all the features of Hoon.
9+
10+If you prefer to learn from the bottom up, feel free to start here.
7
11
8<list/>
12<list/>
docs/using/web.md+4−2
@@ -25,8 +25,10 @@ We ship `tree` as compiled JavaScript on your Urbit, but the source lives in its
25
25
26Your Urbit runs a web server and can be found at either `http://localhost:8080/` (or `8081` if you're running other processes that might be occupying `8080`, you can determine which port your urbit is on by looking at your boot sequence — it's specified there), or `http://your-urbit.urbit.org/`.
26Your Urbit runs a web server and can be found at either `http://localhost:8080/` (or `8081` if you're running other processes that might be occupying `8080`, you can determine which port your urbit is on by looking at your boot sequence — it's specified there), or `http://your-urbit.urbit.org/`.
27
27
28+<span class="red">
28(Make sure you have a desk mounted to unix, as covered in the
29(Make sure you have a desk mounted to unix, as covered in the
29[filesystem walkthrough](/docs/using/filesystem)).
30[filesystem walkthrough](/docs/using/filesystem)).
31+</span>
30
32
31To switch the desk you're serving from:
33To switch the desk you're serving from:
32
34
@@ -38,7 +40,7 @@ To host a file on the web try putting the following in `/home/web/test.md` (from
38
40
39 This is a simple markdown file.
41 This is a simple markdown file.
40
42
41−Create the directory `/home/web/test/` and add two more markdown files in it.
43+Create the directory `/home/web/test/` and add two more markdown files in it.
42
44
43Now modify `/home/web/test.md` to list the children using the `<list/>` JSX:
45Now modify `/home/web/test.md` to list the children using the `<list/>` JSX:
44
46
@@ -56,7 +58,7 @@ To view your file as raw `html`:
56
58
57 http://localhost:8080/test.html
59 http://localhost:8080/test.html
58
60
59−You may have noticed that we just created both `test.md` and `test/`. In Urbit, there is no distinction between a directory and a file. So, if you're adding files directly from unix, simply `mkdir test` and Urbit will treat the file and directory as the same entity.
61+You may have noticed that we just created both `test.md` and `test/`. In Urbit, there is no distinction between a directory and a file. So, if you're adding files directly from unix, simply `mkdir test` and Urbit will treat the file and directory as the same entity.
60
62
61You can use this feature to change your homepage at `your-urbit.urbit.org` with the page `/home/web.md`, where `home` is the current mounted desk. By default, `web.md` will display some info about your urbit, but you can customize it to your heart's content.
63You can use this feature to change your homepage at `your-urbit.urbit.org` with the page `/home/web.md`, where `home` is the current mounted desk. By default, `web.md` will display some info about your urbit, but you can customize it to your heart's content.
62
64