git.iko.soy/urbit.org
on master help sign in
more friendly
commitb7305c101695d369c08d1b50dc0cff90da3b48a5 authorGalen Wolfe-Pauly <mailroom@office-for.com> dateSun 12 Jun 2016, 11:33 (10 years ago) parent7dfce69
4 files changed+51−17
compare with master
unifiedsplit
docs.md+35−11 docs/arvo.md+6−2 docs/hoon.md+6−2 docs/using/web.md+4−2
docs.md+35−11
@@ -10,21 +10,45 @@ sort: 4
1010 <h1 class="blue i-b">Urbit docs</h1>
1111</div>
1212
13−Go to the [technical overview](about/overview) for a high-level
14−architecture description. To install and run Urbit, read forward from the
15−[installation guide](using/install).
13+<div class="col-md-12 head">
1614
17−To begin developing for Urbit, start by learning Hoon [syntax](hoon/syntax),
18−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.
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+
20+To begin developing for Urbit, start by learning Hoon [syntax](hoon/syntax),
21+then walk through the [Arvo tutorials](arvo). The examples and exercises
22+in Arvo will teach you to build high-level programs and interact with the network.
2023
2124Dig 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">
2332
24−Registered academics are required to start with the [Nock definition](nock/definition)
25−and work upward from there.
26−<br/>
27−<br/>
33+<b>Source on GitHub</b>
34+<ul>
35+<li><a href="https://github.com/urbit/urbit">Main repo</a></li>
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>
2852
2953<div class="sections">
3054 <kids grid="true"></kids>
docs/arvo.md+6−2
@@ -1,8 +1,12 @@
11---
22navhome: /docs
3−sort: 4
3+sort: 3
44---
55
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.
711
812<list/>
docs/hoon.md+6−2
@@ -1,8 +1,12 @@
11---
22navhome: /docs
3−sort: 3
3+sort: 4
44---
55
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.
711
812<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
2525
2626Your 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/`.
2727
28+<span class="red">
2829(Make sure you have a desk mounted to unix, as covered in the
2930[filesystem walkthrough](/docs/using/filesystem)).
31+</span>
3032
3133To switch the desk you're serving from:
3234
@@ -38,7 +40,7 @@ To host a file on the web try putting the following in `/home/web/test.md` (from
3840
3941 This is a simple markdown file.
4042
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.
4244
4345Now modify `/home/web/test.md` to list the children using the `<list/>` JSX:
4446
@@ -56,7 +58,7 @@ To view your file as raw `html`:
5658
5759 http://localhost:8080/test.html
5860
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.
6062
6163You 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.
6264