@@ -1,13 +1,55 @@
1−:- :~ navhome/'/docs/'
2− navuptwo/'true'
3− next/'true'
4− sort/'1'
5− title/'Technical overview'
6− ==
7−;>
1+1 :- :~ navhome/'/docs/'
2+2 navuptwo/'true'
3+3 next/'true'
4+4 sort/'1'
5+5 title/'Introduction'
6+6 ==
7+7 ;>
88
99# Docs
1010
11−Welcome to the documentation for the Urbit project, including the Azimuth identity layer, the Arvo operating system, and the Hoon programming language. This documentation is maintained by [Tlon](https://tlon.io) in a public [Github repository](https://github.com/urbit/docs). Issues and contributions are welcome.
11+Welcome to the documentation for the Urbit project, including the Azimuth identity layer, the Arvo operating system, and the Hoon programming language. This documentation is maintained by [Tlon](https://tlon.io) in a public [GitHub repository](https://github.com/urbit/docs). Issues and contributions are welcome.
1212
13−Please make your way to the [Introduction](docs/introduction) for an overview of the docs.
13+The documentation is organized into four high-level sections. Read on to get acquainted.
14+
15+## [Getting Started](/docs/getting-started)
16+
17+If you'd like to install Arvo, get an Azimuth point, and/or get on the Urbit network, you'll find guides here. Dive in, and don't be afraid to [ask for help](mailto:support@urbit.org)!
18+
19+The three pages below are meant to be followed in order.
20+
21+- The [Bridge section](/docs/getting-started/azimuth) is the first step. It tells you how to access your Azimuth identity using our client.
22+- The [guide to installing Urbit](/docs/getting-started/installing-urbit) is the second step. It tells you how to get our software on your machine.
23+- The [guide to booting a ship](/docs/getting-started/booting-a-ship) is the third and final step. It walks you through using what you did in the previous steps to get onto the Arvo network.
24+
25+In addition to those primary pages, the documents below are helpful but optional for using Urbit.
26+
27+- [Creating a Development Ship](/docs/getting-started/creating-a-development-ship), a walkthrough for creating an unnetworked a a platform for coding.
28+- [Operating a Star](/docs/getting-started/creating-a-development-ship)
29+
30+## [Concepts](/docs/concepts)
31+
32+If you're looking for a high-level introduction to the Urbit project and its components, start here.
33+
34+- [Arvo vs. Azimuth](/docs/introduction/arvo-vs-azimuth), a quick explanation of the two parallel systems that compose Urbit.
35+- [Technical Overview](/docs/introduction/technical-overview), a more in-depth description of the entire Urbit stack.
36+- [Contributing](/docs/introduction/contributing), a guide to getting involved with the Urbit project.
37+- [Community Tutorials](/docs/introduction/community-tutorials), a collection of unofficial but useful Urbit learning resources.
38+- [Source Code](/docs/introduction/source-code-overview), an explanation of Urbit's constituent GitHub repos.
39+- [Galaxies, Stars, and Planets](/docs/introduction/galaxies-stars-and-planets), an explanation of the Urbit address-space hierarchy.
40+
41+## [Learn](/docs/learn)
42+
43+If you're interested in contributing to the project, building applications, or understanding the system technically, take a look at our tutorials and explanations of the Urbit components.
44+
45+- [The Hoon Tutorial](/docs/learn/arvo/hoon), for our programming language. To learn the system, start here.
46+- [The Arvo section](/docs/learn/arvo), for the internals of Arvo, the Urbit operating system.
47+
48+## [Reference](/docs/reference)
49+
50+If you're a developer looking for Arvo reference documentation, this section is for you.
51+
52+- [The Glossary](/docs/reference/glossary) will help if you're confused by all the new jargon.
53+- [The Cheat Sheet](/docs/reference/cheat-sheet) is a compact document for looking up Hoon expressions.
54+- [The Hoon Expressions](/docs/reference/hoon-expressions) section contains more comprehensive reference material for Hoon expressions.
55+- [The Standard Library](/docs/reference/library) section documents the Hoon standard library.