@@ -4,6 +4,32 @@ template = "sections/docs.html"
5Welcome 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.
5Welcome 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+The following three guides can get you started.
7−- [Install Urbit](/install)
11+### [Install Urbit](/install)
13+Urbit isn't ready for serious use yet, but it's available to try out. If you have an Azimuth point, you can follow this step-by-step guide to get your point's _keyfile_, which you need to boot your ship. Then you can install Urbit and join the community.
8−- [Operator's Manual](/operations)
15+### [Operator's Manual](/operations)
17+The Operator's Manual will show you how to perform everyday functions on your Urbit.
9−- [Developer's Guide](/develop)
19+### [Developer's Guide](/develop)
21+This guide will teach you how set up an Urbit development environment.
23+## Technical Documentation
25+The documentation proper is contained on the sidebar of this page. It's meant for those interested in development on Urbit, and it's sorted by section:
27+- [Arvo](../arvo) is the Urbit operating system. If you're interested in finding out about the architecture of the system, check out this section.
29+- [Azimuth](../arvo) is the Urbit identity layer. To use Urbit, you need an Azimuth identity.
31+- [Hoon](../hoon) is the functional programming language used to build Urbit. This section contains tutorials that will help you build proficiency in the language.
33+- [Nock](../nock) is the low-level language Hoon compiles to. If you want to understand that absolute fundamentals of Urbit, this section will be of help.
35+- [Vere](../vere) is the Nock interpreter that acts as the layer between Urbit and whatever system (MacOS, Linux, BSD) is running it.