@@ -14,7 +14,7 @@ This guide is broken into five parts:
1414+ [Basic Operations](#operation)
1515
1616_If you just want to install the Urbit OS, Arvo, and don't need to be on the
17−Urbit network, you can skip to [Installing Arvo](#arvo)._
17+network, you can skip to [Installing Arvo](#arvo)._
1818
1919;=
2020 ;h2
@@ -24,8 +24,9 @@ Urbit network, you can skip to [Installing Arvo](#arvo)._
2424
2525Urbit's identity layer, called Azimuth, is a suite of contracts on the Ethereum
2626blockchain. An Azimuth address, called a *point*, functions as an identity and
27−a network address for Arvo, the Urbit OS. An instance of Arvo is called a
28−*ship*. A ship can't use the Arvo network until it's combined with a point.
27+a network address for Arvo, the Urbit operating system. An instance of Arvo is
28+called a *ship*. A ship can't use the Arvo network until it's combined with a
29+point.
2930
3031Throughout this guide, we'll refer to \"Urbit identities\" and \"points\"
3132interchangeably.
@@ -34,28 +35,26 @@ Points are generally not freely available, so you will need to either
3435purchase one or get one from a friend. This guide assumes you have found a way
3536to acquire a point.
3637
37−To get Urbit address space, you'll need two things: an Ethereum address and a
38−person willing to send you the Urbit address space.
38+To get an Urbit identity, you'll need two things: an Ethereum address and a
39+person willing to send you the identity.
3940
4041You'll probably want to start with a planet. Those are cheap identities for
41−everyday use. Find someone who is willing to part with a point: a friend or a
42−stranger selling address space via smart contract. Once they've sent the address
43−space, you can access it using our Bridge software, or any other interface for
44−the Ethereum blockchain. Make sure they send you the name of the point, which
45−looks something like `~lodleb-ritrul`.
42+everyday use. Find someone who is willing to part with a point: a friend, or a
43+stranger selling a point via smart contract. Once they've sent the point, you
44+can access it using our Bridge software.
4645
4746If you bought address space from Tlon, then you should have have received a .zip
48−file that contains an Ethereum address and cryptographic secrets in
49−the form of a PDF.
47+file that contains an Ethereum address and cryptographic secrets on a PDF. Your
48+ownership PDF contains two secrets that must be kept safe:
5049
51−Your ownership PDF contains two secrets that must be kept safe.
52−
53−- *Master Ticket*: This is a master key that allows you to manage every aspect of
54− your address.
50+- *Master Ticket*: This is a master key that allows you to manage every aspect
51+ of your address.
5552
5653- *Ownership Seed BIP39 Mnemonic*: The master ticket encoded as a BIP39 mnemonic
57− for compatibility with most Ethereum wallet software, including our own *Bridge*
58− client.
54+ for compatibility with most Ethereum wallet software, including our own
55+ *Bridge* client.
56+
57+Once you
5958
6059;=
6160 ;h2
@@ -63,14 +62,13 @@ Your ownership PDF contains two secrets that must be kept safe.
6362 ==
6463==
6564
66−Bridge is client that we built for accessing and managing your Urbit identities.
67−Like 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
69−a Mac.
65+Bridge is a client that we built for accessing and managing your Urbit
66+identities. Bridge comes in the form of an offline HTML application that can be
67+run in Firefox, Safari, or Chrome.
7068
7169Importantly, Bridge also automates the process of generating the keyfile that
7270you 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.
71+is booted, it stays booted forever.
7472
7573Download bridge [here](https://github.com/urbit/bridge/releases) and follow
7674the instructions below.
@@ -276,7 +274,7 @@ that you downloaded from bridge.
276274This will look something like `~lodleb-ritrul`. You can see the name of your
277275point(s) when you log into your wallet using the Bridge client.
278276
279−;img@"media.urbit.org/site/bridge-0.png"(width "100%");
277+;img@"http://media.urbit.org/site/bridge-0.png"(width "100%");
280278
281279#### Step 2: Find the path to your keyfile
282280
@@ -377,27 +375,25 @@ $ urbit some-planet
377375
378376Your ship is also accessible through its own web interface. Through the web
379377interface 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
378+of our _Landscape_ feature. This is a user-friendly way to use Talk on the
381379Arvo network and access and materials you've published on your ship. If You're
382380running Arvo locally on your own machine, try opening `http://localhost/` in
383381your browser.
384382
385−Or if you're running your ship on a cloud instance with a static IP address
386−(which we recommend!), something like 212.131.240.20, assuming you've opened up
387−the HTTP port that Arvo uses -- the default is port 80. So
388−`http://212.131.240.20:80/~~/` would go into your browser's URL bar.
389−
390−This way, if you keep your ship running securely in the cloud (usually in a
391−screen or tmux session), you can always access your ships's web interface in any
392−browser on any device, so long as you have your password on hand.
383+Or, if you're running your ship on a cloud instance with a static IP address
384+(which we recommend!), something like 212.131.240.20,
385+`http://212.131.240.20:80/~~/` would go into your browser's URL bar. This way,
386+if you keep your ship running securely in the cloud (usually in a screen or tmux
387+session), you can always access your ships's web interface in any browser on
388+any device.
393389
394390The `/~~/` in the URL will redirect you to a login page, which was generated by
395−Tree, the basic Arvo web interface. The page will tell you to run the +code
396−generator (an Arvo shell script) in your Dojo to get your password. Copy and
397−paste that into your password input box and hit Enter. After loading, you'll
391+Tree, the basic Arvo web interface. The page will tell you to run the `+code`
392+generator (an Arvo shell-script) in your Dojo to get your password. Copy and
393+paste that into the password-input field and hit Enter. After loading, you'll
398394find yourself redirected to your home page, authenticated, where you can then
399395use the navigation bar at the top of the page to visit your Talk web interface
400396and static files.
401397
402398When you use the web interface, your urbit is automatically subscribed to
403−`/urbit-meta` and Fora, our message-board system.
399+`/urbit-meta` and our message-board system, Posts.