@@ -7,35 +7,29 @@ navhome: /docs
8# Getting started
8# Getting started
11−<div class="col-md-8">
13−On disk your Urbit is an append-only log and a checkpoint. Or, in simpler terms, a directory where we keep all of your Urbit’s state. We call this a ‘pier’.
10+On disk your urbit is an append-only log and a checkpoint. Or, in simpler terms, a directory where we keep your urbit’s state. We call this a ‘pier’.
18## Initialize
12## Initialize
20−When you first start an Urbit we create this pier directory and write to it.
14+To create an urbit, we must make a pier and assign it an identity. An urbit with an identity is a 'planet', if it was generated by a 'star' (an urbit that makes more urbits. Accordingly, a 'galaxy' is an urbit that makes stars).
22−To start with a planet (`~fintud-macrep`) and ticket (`~fortyv-tombyt-tabsen-sonres`):
16+To make a planet, you need a ticket from a star. If you have a ticket, like `~fortyv-tombyt-tabsen-sonres`, start your planet `~fintud-macrep` like so:
24− bin/urbit -w fintud-macrep -t fortyv-tombyt-tabsen-sonres
18+ $ bin/urbit -w fintud-macrep -t fortyv-tombyt-tabsen-sonres
26−This will create a directory `fintud-macrep/` and begin the initialization process for that planet. Be patient, it can take a few minutes.
20+This will create a directory `fintud-macrep/` and begin building your urbit. Assembling a planet may take a few minutes.
28−Without a planet anyone can create a comet:
22+If you do not have a ticket, you can still make a 'comet', a parentless urbit drifting thorugh cyberspace. You can specify any name you like.
30− bin/urbit -c comet
24+ $ bin/urbit -c comet
32−This will create a directory `comet/` and start up a random 64-bit comet. You can specify any name you like.
26+This will create the directory `comet/` and generate a 64-bit identity for your urbit.
34## Orientation
28## Orientation
36−When your Urbit is finished booting you should see a `dojo>` prompt. Welcome!
30+When your urbit is finished booting you should see a `dojo>` prompt. Welcome!
38−By default your Urbit is quite bare bones. Let's take a very short stroll through what's running by default:
32+By default your urbit is quite bare-bones. Let's stroll through what's already running:
40### Shell — `:dojo`
34### Shell — `:dojo`
@@ -52,11 +46,11 @@ Good.
53### Messaging — `:talk`
47### Messaging — `:talk`
55−Use `^X` to change your prompt. Let's join the main Urbit chat channel:
49+Use `^X` (ctrl-x) to change your prompt. Let's join the main urbit chat channel:
57 ~fitund-macrep:talk() ;join ~doznec/urbit-meta
51 ~fitund-macrep:talk() ;join ~doznec/urbit-meta
59−This may take a bit as `:talk` is stateful so your Urbit will download some backlog. `/urbit-meta` is the place to ask questions, get help and talk about anything Urbit related.
53+`:talk` is stateful, so your urbit will download a backlog. `/urbit-meta` is the place to ask questions, get help and talk about anything Urbit-related.
61### Web — `:tree`
55### Web — `:tree`
@@ -64,7 +58,7 @@ Urbit is also accessible through the web. Try opening:
65 http://localhost:8080/
59 http://localhost:8080/
67−in your favorite browser. You'll be prompted to use `+code`. This page was generated by `:tree`, the basic Urbit web interface. You can also access your Urbit through `http://fintud-macrep.urbit.org` (where `fintud-macrep` is your planet name).
61+in your favorite browser. You'll be prompted to use `+code`. This page was generated by `:tree`, the basic urbit web interface. You can also access your urbit through `http://fintud-macrep.urbit.org` (where `fintud-macrep` is your planet name).
69### Filesystem — `%clay`
63### Filesystem — `%clay`
@@ -79,7 +73,7 @@ This should produce:
80which indicates the command was processed.
74which indicates the command was processed.
82−`|mount %` will cause a `home/` directory to appear inside your pier folder. Changes to these files are automatically synced into your Urbit.
76+`|mount %` will cause a `home/` directory to appear inside your pier folder. Changes to these files are automatically synced into your urbit.
84## Learn more
78## Learn more
@@ -87,6 +81,6 @@ We go into much greater detail about using each of these components in our walkt
88<list src="."></list>
82<list src="."></list>
90−With your Urbit up and running you know enough to start learning to program:
84+With your urbit up and running, you know enough to start learning to program:
92−<list src="../programming/deep"></list>
86+<list src="../hoon/"></list>