@@ -6,34 +6,37 @@
66
77# Introduction
88
9−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.
9+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.
1010
11−The documentation is organized into four high-level sections, and further divided between Azimuth and Arvo. Read on to get acquainted.
11+The documentation is organized into four high-level sections. Read on to get acquainted.
1212
13−## [Introduction](/docs/introduction)
13+## [Introduction](docs/introduction)
1414
1515If you're looking for a high-level introduction to the Urbit project and its components, start here.
1616
17−- See [Technical Overview](/docs/introduction/technical-overview) for an in-depth description of Urbit.
18−- See [Contributing](/docs/introduction/contributing) for a guide to getting involved with the Urbit project.
17+- [Arvo vs. Azimuth](docs/introduction/arvo-vs-azimuth), a quick explanation of the two parallel systems that compose Urbit.
18+- [Technical Overview](docs/introduction/technical-overview), a more in-depth description of the entire Urbit stack.
19+- [Contributing](docs/introduction/contributing), a guide to getting involved with the Urbit project.
20+- [Community Tutorials](/docs/introduction/community), a collection of unofficial but useful Urbit learning resources.
21+- [Source Code](/docs/introduction/source), an explanation of Urbit's constituent GitHub repos.
1922
20−## [Getting Started](/docs/getting-started)
23+## [Getting Started](docs/getting-started)
2124
2225If 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](support@urbit.org)!
2326
24−- [Get started with Azimuth](/docs/getting-started/azimuth), the identity system.
25−- [Get started with Arvo](/docs/getting-started/arvo), the Urbit OS.
27+- [The Installation Guide](docs/introduction/installation), a step-by-step walkthrough you for getting Urbit running.
28+- [The Azimuth section](docs/getting-started/azimuth), guides to managing your Azimuth identities.
2629
27−## [Learn](/docs/learn)
30+## [Learn](docs/learn)
2831
29−If you're interested in contributing to the Urbit project, building applications, or understanding the system technically, find tutorials and explanations of all the components of the system.
32+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.
3033
31−- If you want to dive into learning Urbit, we recommend starting with the [Hoon Tutorial](/docs/learn/arvo/hoon).
32−- For Arvo internals, start at [Arvo](/docs/learn/arvo).
34+- [The Hoon Tutorial](docs/learn/arvo/hoon), for our programming language. To learn the system, start here.
35+- [The Arvo section](docs/learn/arvo), for the internals of Arvo, the Urbit operating system.
3336
34−## [Reference](/docs/reference)
37+## [Reference](docs/reference)
3538
3639If you're a developer looking for Arvo reference documentation, this section is for you.
3740
38−- Confused about all the new words? Check out the [Glossary](docs/reference/glossary).
39−- Don't miss the helpful Hoon rune [Cheat Sheet](docs/reference/cheat-sheet).
41+- [The Glossary](docs/reference/glossary) will help if you're confused by all the new jargon.
42+- [The Cheat Sheet](docs/reference/cheat-sheet) is a compact way to look up Hoon expressions.