@@ -4,36 +4,34 @@ weight = 1
4sort_by = "weight"
4sort_by = "weight"
5template = "sections/docs/chapters.html"
5template = "sections/docs/chapters.html"
7−Pages in this section are guides to getting you started with Urbit.
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
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.
13−## Urbit Identities
12+### [Step 1: Using Bridge](using-bridge)
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.
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)
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.
21−## Guides
20+### [Step 3: Booting a Ship](booting-a-ship)
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.
25−### [Using Bridge](using-bridge)
24+### [Optional: Creating a Development Ship](creating-a-development-ship)
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.
29−### [Installing Urbit](installing-urbit)
28+## Terminology
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:
33−### [Booting a Ship](booting-a-ship)
32+- Arvo is the name of the Urbit operating system.
34−
33+- An instance of the Arvo operating system is called a _ship_.
35−This guide will walk you through the process of getting your ship operational and on the Arvo network.
34+- Ships communicate with one another over "the Arvo network."
36−
35+- Azimuth is an Ethereum-based PKI used to give each ship a unique identity on the Arvo network.
37−### [Creating a Development Ship](creating-a-development-ship)
36+- An Azimuth identity is called a _point_. You'll need a point to use the Arvo network.
38−
37+- Urbit refers to the project as a whole, including Arvo, Azimuth, and other system components.
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.