@@ -10,45 +10,45 @@ This guide is broken into five parts:
1010+ [Acquiring an Urbit Identity](#acquire)
1111+ [Using Bridge](#bridge)
1212+ [Installing Arvo](#arvo)
13−+ [Booting Your Ship](#setup)
13++ [Booting Your Ship](#boot)
1414+ [Basic Operations](#operation)
1515
16−_If you just want to install the Urbit OS, Arvo, and don’t need to be on the
16+_If you just want to install the Urbit OS, Arvo, and don't need to be on the
1717Urbit network, you can skip to [Installing Arvo](#arvo)._
1818
19−
2019;=
21− ;h3
20+ ;h2
2221 ;div(id "acquire"): Acquiring an Urbit Identity
2322 ==
2423==
2524
26−Urbit’s identity layer, called Azimuth, is a suite of contracts on the Ethereum
25+Urbit's identity layer, called Azimuth, is a suite of contracts on the Ethereum
2726blockchain. An Azimuth address, called a *point*, functions as an identity and
2827a network address for Arvo, the Urbit OS. An instance of Arvo is called a
2928*ship*. A ship can't use the Arvo network until it's combined with a point.
3029
31−Throughout this guide, we’ll refer to "Urbit identities" and "points"
30+Throughout this guide, we'll refer to \"Urbit identities\" and \"points\"
3231interchangeably.
3332
3433Points are generally not freely available, so you will need to either
3534purchase one or get one from a friend. This guide assumes you have found a way
3635to acquire a point.
3736
38−To get Urbit address space, you’ll need two things: an Ethereum address and a
37+To get Urbit address space, you'll need two things: an Ethereum address and a
3938person willing to send you the Urbit address space.
4039
41−You’ll probably want to start with a planet. Those are cheap identities for
40+You'll probably want to start with a planet. Those are cheap identities for
4241everyday use. Find someone who is willing to part with a point: a friend or a
43−stranger selling address space via smart contract. Once they’ve sent the address
42+stranger selling address space via smart contract. Once they've sent the address
4443space, you can access it using our Bridge software, or any other interface for
45−the Ethereum blockchain.
44+the Ethereum blockchain. Make sure they send you the name of the point, which
45+looks something like `~lodleb-ritrul`.
4646
4747If you bought address space from Tlon, then you should have have received a .zip
4848file that contains an Ethereum address and cryptographic secrets in
4949the form of a PDF.
5050
51−Your ownership PDF contains two secrets that must be kept safe.""
51+Your ownership PDF contains two secrets that must be kept safe.
5252
5353- *Master Ticket*: This is a master key that allows you to manage every aspect of
5454 your address.
@@ -58,36 +58,82 @@ Your ownership PDF contains two secrets that must be kept safe.""
5858 client.
5959
6060;=
61− ;h3
61+ ;h2
6262 ;div(id "bridge"): Using Bridge
6363 ==
6464==
6565
6666Bridge is client that we built for accessing and managing your Urbit identities.
6767Like Wallet Generator, Bridge comes in the form of an offline HTML application
68−that can be run in Firefox on all platforms, and also in Chrome if you’re using
68+that can be run in Firefox on all platforms, and also in Chrome if you're using
6969a Mac.
7070
71−Importantly, Bridge also automates the process of generating the key-file that
71+Importantly, Bridge also automates the process of generating the keyfile that
7272you will need a single time to boot your ship on the Arvo network. Once a ship
73−is booted, it isn’t booted again. It stays booted forever.
73+is booted, it isn't booted again. It stays booted forever.
74+
75+Download bridge [here](https://github.com/urbit/bridge/releases) and follow
76+the instructions below.
77+
78+#### Step 1: Welcome
79+
80+Click `Open a Wallet`.
81+
82+#### Step 2: Select a Network
83+
84+On the dropdown menu, make sure that `Main Network` is selected. Then click
85+`Continue ->`.
86+
87+#### Step 3: Open a Wallet
88+
89+On this dropdown menu, choose how you'd like to access your Ethereum wallet.
90+If you aren't using Hardware wallets (a Ledger or a Trezor), you'll want to use
91+your Ethereum wallet's BIP39 Mnemonic.
92+
93+If you received a point from Tlon and received paper wallets in the form of
94+PDFs, choose `Urbit Master Ticket`.
95+
96+Select the appropriate option and click `Continue ->`.
97+
98+#### Step 4: Accept Your Transfer
7499
75−Download bridge [here](https://github.com/urbit/bridge/releases). It runs in
76−your browser contains instructions to get the key that you need to boot your
77−urbit. We recommend using the "BIP39 Mnemonic" method to access your wallet.
100+If you were sent a point, then you should see a graphic under
101+`Incoming Transfers`. Click the `Details ->` link under that graphic.
102+
103+Now you'll be on the management page of your point. The transfer isn't completed
104+yet, so click `Accept incoming transfer`. Then check both boxes and and click
105+their associated `Sign Transaction` and `Send Transaction` buttons.
106+
107+#### Step 5: Set Your Networking Keys
108+
109+You'll be returned to your point screen. Notice that that links and buttons
110+are now clickable. You know own this point!
111+
112+Click the link that says `Set Urbit networking keys`. Choose two different,
113+64-character long strings of hexademical, check the box, and, like before, check
114+both boxes and press both buttons.
115+
116+#### Step 6: Generate Your Keyfile
117+
118+Return to your point by clicking its name at the navigation bar on the top of
119+the page.
120+
121+Click the `Generate Urbit Keyfile` button and you'll be taken to a page with a
122+field titled `Network key`. That field should be filled in already. Click
123+`Generate ->`, which will download a the keyfile onto your machine.
78124
79125
80126;=
81− ;h3
127+ ;h2
82128 ;div(id "arvo"): Installing Arvo
83129 ==
84130==
85131
86−Now you’re ready to install the Arvo software. You’re almost there!
132+Now you're ready to install the Arvo software. You're almost there!
87133
88134Arvo can only run on a Unix-like operating system -- Ubuntu,
89−Fedora, macOS, and FreeBSD all work well. If you’re using Windows, you’ll need
90−to get one of the aforementioned systems. Don’t worry: most of them are free.
135+Fedora, macOS, and FreeBSD all work well. If you're using Windows, you'll need
136+to get one of the aforementioned systems. Don't worry: most of them are free.
91137
92138We have different installation instructions for different platforms. To install
93139Arvo, run the Bash commands that are listed for your operating system.
@@ -100,7 +146,7 @@ with the line below:
100146Urbit: a personal server operating function
101147```
102148
103−##### MacOS
149+#### MacOS
104150
105151We recommend using the Homebrew package manager to install Arvo on MacOS.
106152
@@ -117,7 +163,7 @@ sudo ninja -C ./build/ meson-install
117163urbit
118164```
119165
120−##### Ubuntu or Debian
166+#### Ubuntu or Debian
121167
122168```
123169# Bash
@@ -147,7 +193,7 @@ sudo ninja -C ./build/ install
147193urbit
148194```
149195
150−##### Fedora
196+#### Fedora
151197
152198```
153199# Bash
@@ -187,7 +233,7 @@ sudo /usr/local/bin/ninja -C ./build/ install
187233urbit
188234```
189235
190−##### Arch Linux
236+#### Arch Linux
191237
192238```
193239# Bash
@@ -213,36 +259,38 @@ urbit -F zod -A /path/to/arvo -s -c zod -S
213259
214260If you want to get on the Arvo network with your point, then continue to the
215261next section.
216−
262+
263+
217264;=
218− ;h3
265+ ;h2
219266 ;div(id "boot"): Booting Your Urbit
220267 ==
221268==
222269
223−Now the rubber meets the road. You’ll be booting your ship with the key-file
270+
271+Now the rubber meets the road. You'll be booting your ship with the keyfile
224272that you downloaded from bridge.
225273
226−##### Step 1: Find Your Point's Name
274+#### Step 1: Find Your Point's Name
227275
228276This will look something like `~lodleb-ritrul`. You can see the name of your
229277point(s) when you log into your wallet using the Bridge client.
230278
231279;img@"media.urbit.org/site/bridge-0.png"(width "100%");
232280
233−##### Step 2: Find the path to your key-file
281+#### Step 2: Find the path to your keyfile
234282
235−Find the absolute path to the key-file that you downloaded from Bridge. Copy it.
283+Find the absolute path to the keyfile that you downloaded from Bridge. Copy it.
236284
237−##### Step 3: Run the boot command
285+#### Step 3: Run the boot command
238286
239287Type `cd` in your terminal to return to your home directory. If you want to
240−store your ship somewhere besides your home directory, change the terminal’s
288+store your ship somewhere besides your home directory, change the terminal's
241289working directory to the desired directory.
242290
243291Run the command below, except with `~sample-planet` replaced by the name of your
244292Urbit identity, and `path/to/my-planet.key` replaced with the path to your
245−key-file:
293+keyfile:
246294
247295```
248296urbit -w ~sample-planet -k path/to/my-planet.key
@@ -252,20 +300,20 @@ This will create a directory called `sample-planet/` and begin building your
252300ship. It may take a few minutes.
253301
254302When your ship is finished booting, you will see the `~sample-planet:dojo>`
255−prompt. At that point, you should permanently erase your key-file from your
303+prompt. At that point, you should permanently erase your keyfile from your
256304machine.
257305
258306;=
259− ;h3
307+ ;h2
260308 ;div(id "operation"): Basic Operations
261309 ==
262310==
263311
264312Welcome to your urbit! There's a few things you should do to become oriented.
265313
266−##### Dojo
314+#### Dojo
267315
268−Let’s try out the Dojo, the Arvo command line and Hoon REPL:
316+Let's try out the Dojo, the Arvo command line and Hoon REPL:
269317
270318```
271319~sample-planet:dojo> (add 2 2)
@@ -280,7 +328,7 @@ Should produce:
280328
281329Good.
282330
283−##### Mounting
331+#### Mounting
284332
285333Clay, the Arvo filesystem, isn't mounted to Unix by default. Switch to the Dojo
286334prompt and run:
@@ -301,11 +349,11 @@ which indicates that the command was processed.
301349Unix. Changes to these files are automatically synced into your ship.
302350
303351
304−##### Talk
352+#### Talk
305353
306354Use `ctrl-x` to toggle between the Dojo and the Talk prompts.
307355
308−While on the Talk prompt, let’s join the main Urbit chat channel, `/urbit-meta`:
356+While on the Talk prompt, let's join the main Urbit chat channel, `/urbit-meta`:
309357
310358```
311359~sample-planet:talk[] ;join /urbit-meta
@@ -315,7 +363,7 @@ Talk is stateful, so your ship will download a backlog. `/urbit-meta` is the
315363place to ask questions, get help, talk about anything Urbit-related, and meet
316364everyone on here.
317365
318−##### Shutting Down and Restarting
366+#### Shutting Down and Restarting
319367
320368You can turn your ship off with `ctrl-d` from the Talk or Dojo prompts.
321369
@@ -324,13 +372,13 @@ To restart your ship, simply pass the name of your pier:
324372```
325373$ urbit some-planet
326374```
327−
328−##### Landscape
375+
376+#### Landscape
329377
330378Your ship is also accessible through its own web interface. Through the web
331−interface you’ll have access to our chat and message boards, the two components
332−of our "Landscape" feature. This is a user-friendly way to chat with Talk on the
333−Arvo network and access and materials you’ve published on your ship. If You're
379+interface you'll have access to our chat and message boards, the two components
380+of our _Landscape_ feature. This is a user-friendly way to chat with Talk on the
381+Arvo network and access and materials you've published on your ship. If You're
334382running Arvo locally on your own machine, try opening `http://localhost/` in
335383your browser.
336384