@@ -36,8 +36,7 @@ While you're downloading, read about Urbit ships:
39−In the Urbyte exercises you'll be running what we call a "fake
39+In the Urbyte exercises you'll be running what we call a "comet". A string starting with `~`, like `~zod`, is what Urbit
40−`~zod`." A string starting with `~`, like `~zod`, is what Urbit
41calls a *ship*.
40calls a *ship*.
43A *ship* is one number which means four things: a network address,
42A *ship* is one number which means four things: a network address,
@@ -46,35 +45,37 @@ computer.
47We write this number in a base-256 format, where each digit is a
46We write this number in a base-256 format, where each digit is a
48syllable. Imagine if your phone number was a pronounceable
47syllable. Imagine if your phone number was a pronounceable
49−string which sounded like a name in a foreign language.
48+string which sounded like a name in a foreign language. `~zod`
49+is ship zero (making it a very important ship indeed!). An ordinary
50+user-level ship is a "planet", a 32-bit number which becomes
51+a four-syllable string, like `~talsur-todres`.
51−`~zod` is ship zero, making it a very important ship indeed.
53+*Comets*, at 128-bits or 16 syllables, are
52−Your "fakezod" thinks it's `~zod`, but no one can talk to it.
54+disposable identities that anyone can make for free to
53−(An ordinary user-level ship is a 32-bit number which becomes
55+join the live network. Thus, comets make the ideal ship for
54−a four-syllable string, like `~talsur-todres`.)
56+playing around with Hoon, asking for help from other Urbit devs in [`:talk`](http://urbit.org/docs/using/messaging/) if you
55−
57+need it, and showing off Urbit to your hacker friends.
56−A fakezod is not the true Urbit experience, of course. But it's
57−ideal if all you want to do is play around with Hoon. If you
58−have a real urbit ship, of course you can use that instead.
60## Create and restart
59## Create and restart
62−To create your fakezod, run:
61+To create your comet, run:
65−$ git clone https://github.com/urbit/arvo/
64+$ cd ~
66−$ urbit -FI ~zod -A arvo -c myship
65+$ mkdir urbit
69−This will take about 30 seconds and spin out a bunch of boot
70+This will take a few minutes and will spin out a bunch of boot
70−messages. At the end, you'll see:
71+messages. At the end, you'll see something like:
73ames: on localhost, UDP 31337.
74ames: on localhost, UDP 31337.
74http: live (insecure, public) on 8080
75http: live (insecure, public) on 8080
75http: live ("secure", public) on 8443
76http: live ("secure", public) on 8443
76http: live (insecure, loopback) on 12321
77http: live (insecure, loopback) on 12321
77−~zod:dojo>
78+~palnul_nocser:dojo>
80To make sure everything is working, type `(add 2 2)` at the
81To make sure everything is working, type `(add 2 2)` at the
@@ -87,8 +88,8 @@ http: live ("secure", public) on 8443
87http: live (insecure, loopback) on 12321
88http: live (insecure, loopback) on 12321
88> (add 2 2)
89> (add 2 2)
93That's super awesome! You made your first noun! We'll make a
94That's super awesome! You made your first noun! We'll make a
94few more in a second. First, quit Urbit with `ctrl-d`:
95few more in a second. First, quit Urbit with `ctrl-d`:
@@ -96,15 +97,15 @@ few more in a second. First, quit Urbit with `ctrl-d`:
97> (add 2 2)
98> (add 2 2)
99−~zod:dojo>
100+~palnul_nocser:dojo>
103−You now have an Urbit image, or *pier*, in the `myship` directory.
104+You now have an Urbit image, or *pier*, in the `mycomet` directory.
104Right now the only thing in your pier is Urbit's system files:
105Right now the only thing in your pier is Urbit's system files:
107−$ ls -a myship
108+$ ls -a /path/to/mycomet
108./ ../ .urb/
109./ ../ .urb/
@@ -112,13 +113,13 @@ Restarting uses almost the same command, but without `-c` (which
112means "create"). There are also fewer startup messages:
113means "create"). There are also fewer startup messages:
115−$ urbit -FI ~zod myship
116+$ urbit mycomet
117ames: on localhost, UDP 31337.
118ames: on localhost, UDP 31337.
118http: live (insecure, public) on 8080
119http: live (insecure, public) on 8080
119http: live ("secure", public) on 8443
120http: live ("secure", public) on 8443
120http: live (insecure, loopback) on 12321
121http: live (insecure, loopback) on 12321
121−~zod:dojo>
122+~palnul_nocser:dojo>
124Note also that Urbit is an ACID database. You can stop it
125Note also that Urbit is an ACID database. You can stop it
@@ -128,11 +129,15 @@ manage to corrupt a pier, it's a bug; please let us know.
129## Let's make a noun
130## Let's make a noun
131−We already made a noun. Let's make another. (We won't show the
132+You've already made a noun. Let's make another!
134+*We won't show the `~palnul_nocser:dojo> ` prompt from here on out.
132−`~zod:dojo> ` prompt in future, just the echoed command.)
135+We'll just show the echoed command.*
135−~zod:dojo> 42
139+~palnul_nocser:dojo> 42
138You'll see:
143You'll see:
@@ -140,7 +145,6 @@ You'll see:
146## Understanding nouns
150## Understanding nouns
@@ -189,7 +193,7 @@ Why not try it again to make sure?
189Can we add another zero?
193Can we add another zero?
192−~zod:dojo> 420
196+> 420
195Wat? When you tried to type that next zero and turn `420` into
199Wat? When you tried to type that next zero and turn `420` into
@@ -260,7 +264,7 @@ Each number is an atom; each dot is a cell.
260And we're done! Type `|exit` to exit:
264And we're done! Type `|exit` to exit:
263−~zod:dojo> |exit
267+~palnul_nocser:dojo> |exit
264%drum-exit
268%drum-exit