@@ -4,36 +4,34 @@ weight = 1
44sort_by = "weight"
55template = "sections/docs/chapters.html"
66+++
7−Pages in this section are guides to getting you started with Urbit.
87
9−But first, the absolute basics. Arvo is the name of the Urbit operating system and the name of network. Azimuth is the name of the Urbit identity layer. Urbit is the project as the whole.
8+# Getting Started
109
11−An instance of the Arvo operating system is called a _ship_. If you want to get on the Arvo network, you need an Azimuth identity, called a _point_.
10+Welcome to Urbit, a personal server. Urbit isn't ready for serious use yet, but it's available to try out. Follow this step-by-step guide to get an Azimuth point, install Urbit, and join the community.
1211
13−## Urbit Identities
12+### [Step 1: Using Bridge](using-bridge)
1413
15−An Azimuth point functions as an identity and a network address for Arvo. A ship can't use the Arvo network unless it's been booted with the keys registered to a point.
14+In order to join the Urbit network, you need an Azimuth point, which acts like an identity and a password for your Urbit ship. Bridge is our client for managing Azimuth points. This guide tells you how to use Bridge to get your point's _keyfile_, which you need to boot your ship.
1615
17−Points are generally not freely available, so you will need to either purchase one or get one from a friend. To receive one, you will need an Ethereum wallet that supports the BIP39 mnemonic seed functionality, which allows you to access your wallet with a series of dictionary words. Hardware wallets, such as Ledger and TREZOR devices, satisfy this requirement. So do various web-based wallets.
16+### [Step 2: Installing Urbit](installing-urbit)
1817
19−Once you have such a wallet, give your Ethereum address to the person who agreed to give you a point. Have them transfer the point to your address, and continue to the with our guides below.
18+The Urbit software is a command-line application that runs the Arvo operating system. This guide walks you through the installation process.
2019
21−## Guides
20+### [Step 3: Booting a Ship](booting-a-ship)
2221
23−Follow these guides in the order that they are listed.
22+This guide teaches you how to get your ship operational and onto the Arvo network.
2423
25−### [Using Bridge](using-bridge)
24+### [Optional: Creating a Development Ship](creating-a-development-ship)
2625
27−Bridge is our client for managing Azimuth points. This guide will tell you how to use it to get your point's _keyfile_, the item you need to boot your ship booted onto the Arvo network.
26+If you want to develop software for Arvo, or if you just want to try the operating system without connecting to the network, this section is for you.
2827
29−### [Installing Urbit](installing-urbit)
28+## Terminology
3029
31−This guide will tell you everything you need to know about installing our software.
30+You've already encountered some new terminology on this page, and you'll encounter more as you proceed with this guide. Let's go over the basics:
3231
33−### [Booting a Ship](booting-a-ship)
34−
35−This guide will walk you through the process of getting your ship operational and on the Arvo network.
36−
37−### [Creating a Development Ship](creating-a-development-ship)
38−
39−If you just want to do development work with Arvo, and don't need to be on the Urbit network, this section is for you.
32+- Arvo is the name of the Urbit operating system.
33+- An instance of the Arvo operating system is called a _ship_.
34+- Ships communicate with one another over "the Arvo network."
35+- Azimuth is an Ethereum-based PKI used to give each ship a unique identity on the Arvo network.
36+- An Azimuth identity is called a _point_. You'll need a point to use the Arvo network.
37+- Urbit refers to the project as a whole, including Arvo, Azimuth, and other system components.