@@ -1,9 +1,40 @@
1:- :~ navhome/'/docs/'
1:- :~ navhome/'/docs/'
3 title/'Introduction'
3 title/'Introduction'
7# Introduction
8# Introduction
9−Learn more about the Urbit project here before delving deeper into the developer documentation.
10+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.
12+The documentation is organized into four high-level sections, and further divided between Azimuth and Arvo. Read on to get acquainted.
14+## [Introduction](docs/introduction)
16+If you're looking for a high-level introduction to the Urbit project and its components, start here.
18+- See [Technical Overview](docs/introduction/technical-overview) for an in-depth description of Urbit.
19+- See [Contributing](docs/introduction/contributing) for a guide to getting involved with the Urbit project.
21+## [Getting Started](docs/getting-started)
23+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](support@urbit.org)!
25+- [Get started with Azimuth](docs/getting-started/azimuth), the identity system.
26+- [Get started with Arvo](docs/getting-started/arvo), the Urbit OS.
28+## [Learn](docs/learn)
30+If you're interested in contributing to the Urbit project, building applications, or understanding the system technically, find tutorials and explanations of all the compontents of the system.
32+- If you want to dive into learning Urbit, we recommend starting with the [Hoon Tutorial](docs/learn/arvo/hoon).
33+- For Arvo internals, start at [Arvo](docs/learn/arvo).
35+## [Reference](docs/reference)
37+If you're a developer looking for Arvo reference documentation, this section is for you.
39+- Confused about all the new words? Check out the [Glossary](docs/reference/glossary).
40+- Don't miss the helpful Hoon rune [Cheat Sheet](docs/reference/cheat-sheet).