@@ -36,8 +36,7 @@ While you're downloading, read about Urbit ships:
3636
3737## Ships
3838
39−In the Urbyte exercises you'll be running what we call a "fake
40−`~zod`." A string starting with `~`, like `~zod`, is what Urbit
39+In the Urbyte exercises you'll be running what we call a "comet". A string starting with `~`, like `~zod`, is what Urbit
4140calls a *ship*.
4241
4342A *ship* is one number which means four things: a network address,
@@ -46,35 +45,37 @@ computer.
4645
4746We write this number in a base-256 format, where each digit is a
4847syllable. 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`.
5052
51−`~zod` is ship zero, making it a very important ship indeed.
52−Your "fakezod" thinks it's `~zod`, but no one can talk to it.
53−(An ordinary user-level ship is a 32-bit number which becomes
54−a four-syllable string, like `~talsur-todres`.)
55−
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.
53+*Comets*, at 128-bits or 16 syllables, are
54+disposable identities that anyone can make for free to
55+join the live network. Thus, comets make the ideal ship for
56+playing around with Hoon, asking for help from other Urbit devs in [`:talk`](http://urbit.org/docs/using/messaging/) if you
57+need it, and showing off Urbit to your hacker friends.
5958
6059## Create and restart
6160
62−To create your fakezod, run:
61+To create your comet, run:
6362
6463```
65−$ git clone https://github.com/urbit/arvo/
66−$ urbit -FI ~zod -A arvo -c myship
64+$ cd ~
65+$ mkdir urbit
66+$ cd urbit
67+$ urbit -c mycomet
6768```
6869
69−This will take about 30 seconds and spin out a bunch of boot
70−messages. At the end, you'll see:
70+This will take a few minutes and will spin out a bunch of boot
71+messages. At the end, you'll see something like:
7172
7273```
7374ames: on localhost, UDP 31337.
7475http: live (insecure, public) on 8080
7576http: live ("secure", public) on 8443
7677http: live (insecure, loopback) on 12321
77−~zod:dojo>
78+~palnul_nocser:dojo>
7879```
7980
8081To make sure everything is working, type `(add 2 2)` at the
@@ -87,8 +88,8 @@ http: live ("secure", public) on 8443
8788http: live (insecure, loopback) on 12321
8889> (add 2 2)
89904
90−~zod:dojo>
9191```
92+~palnul_nocser:dojo>
9293
9394That's super awesome! You made your first noun! We'll make a
9495few 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`:
9697```
9798> (add 2 2)
98994
99−~zod:dojo>
100+~palnul_nocser:dojo>
100101$
101102```
102103
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.
104105Right now the only thing in your pier is Urbit's system files:
105106
106107```
107−$ ls -a myship
108+$ ls -a /path/to/mycomet
108109./ ../ .urb/
109110```
110111
@@ -112,13 +113,13 @@ Restarting uses almost the same command, but without `-c` (which
112113means "create"). There are also fewer startup messages:
113114
114115```
115−$ urbit -FI ~zod myship
116+$ urbit mycomet
116117[...]
117118ames: on localhost, UDP 31337.
118119http: live (insecure, public) on 8080
119120http: live ("secure", public) on 8443
120121http: live (insecure, loopback) on 12321
121−~zod:dojo>
122+~palnul_nocser:dojo>
122123```
123124
124125Note 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.
128129
129130## Let's make a noun
130131
131−We already made a noun. Let's make another. (We won't show the
132−`~zod:dojo> ` prompt in future, just the echoed command.)
132+You've already made a noun. Let's make another!
133+
134+*We won't show the `~palnul_nocser:dojo> ` prompt from here on out.
135+We'll just show the echoed command.*
136+
133137
134138```
135−~zod:dojo> 42
139+~palnul_nocser:dojo> 42
140+42
136141```
137142
138143You'll see:
@@ -140,7 +145,6 @@ You'll see:
140145```
141146> 42
14214742
143−~zod:dojo>
144148```
145149
146150## Understanding nouns
@@ -189,7 +193,7 @@ Why not try it again to make sure?
189193Can we add another zero?
190194
191195```
192−~zod:dojo> 420
196+> 420
193197```
194198
195199Wat? 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.
260264And we're done! Type `|exit` to exit:
261265
262266```
263−~zod:dojo> |exit
267+~palnul_nocser:dojo> |exit
264268%drum-exit
265269$
266270```