@@ -5,23 +5,26 @@ template = "sections/docs.html"
6Welcome to the documentation for the Urbit project. This documentation is maintained by [Tlon](https://tlon.io) in a public [Github repository](https://github.com/urbit/docs). Issues and contributions are welcome.
6Welcome to the documentation for the Urbit project. This documentation is maintained by [Tlon](https://tlon.io) in a public [Github repository](https://github.com/urbit/docs). Issues and contributions are welcome.
8+If you already know what you're looking for, the easiest way to find it is with the search box located on the left.
10+Sections are ordered pedagogically, so the typical user will want to read them in the order in which they are presented.
12+### [Concepts](@/docs/concepts/_index.md)
14+If you're new to Urbit, we recommend starting by reading the Concepts section. Urbit is a complex project with many new ideas to grasp, and this section introduces the most critical ideas in a logical order.
8### [Glossary](@/docs/glossary/_index.md)
16### [Glossary](@/docs/glossary/_index.md)
10−We recommend getting started with the Glossary, which explains Urbit concepts in an accessible, wiki-like format. Glossary pages will point you in the direction of more substantial documentation in other sections like Tutorials and Reference, so browsing it will help you discover the rest of the docs. Also note the search box, which is a handy way to look a term up.
18+The Glossary gives brief summaries of all major Urbit concepts, and so may be utilized as a quick overview for various concepts without getting lost in the details. Glossary pages will also point you in the direction of more substantial documentation in other sections like Tutorials and Reference, so browsing it will help you discover the rest of the docs.
12| Featured Glossary Terms |
20| Featured Glossary Terms |
14| [Arvo](@/docs/glossary/arvo.md) - [Azimuth](@/docs/glossary/azimuth.md) - [Hoon](@/docs/glossary/hoon.md) - [Landscape](@/docs/glossary/landscape.md) - [Planet](@/docs/glossary/planet.md) - [Ship](@/docs/glossary/ship.md)|
22| [Arvo](@/docs/glossary/arvo.md) - [Azimuth](@/docs/glossary/azimuth.md) - [Hoon](@/docs/glossary/hoon.md) - [Landscape](@/docs/glossary/landscape.md) - [Planet](@/docs/glossary/planet.md) - [Ship](@/docs/glossary/ship.md)|
24+### [Usage Guides](@/docs/usage/_index.md)
17−### [Tutorials](@/docs/tutorials/_index.md)
19−Tutorials contains learning materials about the system, enough where you can develop on Urbit.
21−### [Reference](@/docs/reference/_index.md)
26+### [Developer Guides](@/docs/dev/_index.md)
23−Reference contains technical reference documentation for Hoon and other components of the system. Keep reading if you need to look up a Hoon expression or a standard-library function.
25### [Troubleshooting Knowledgebase](https://github.com/urbit/support/wiki)
28### [Troubleshooting Knowledgebase](https://github.com/urbit/support/wiki)
27−While not a part of the docs proper, our troubleshooting wiki is the best place to go if you're trying to find a solution to an Urbit technical problem.
30+While not a part of the docs proper, our troubleshooting wiki is the best place to go if you're trying to find a solution to an issue with your [ship](@/docs/glossary/ship.md).