@@ -10,7 +10,7 @@
1010
1111Welcome 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−The documentation is organized into four high-level sections. Read on to get acquainted.
13+The documentation is organized into five high-level sections. Read on to get acquainted.
1414
1515## [Getting Started](/docs/getting-started)
1616
@@ -27,23 +27,38 @@ In addition to those primary pages, the documents below are helpful but optional
2727- [Creating a Development Ship](/docs/getting-started/creating-a-development-ship), a walkthrough for creating a walkthrough for creating a disposable ship, disconnected from the Arvo network, for hacking on Urbit, developing applications, and learning.
2828- [Operating a Star](/docs/getting-started/creating-a-development-ship)
2929
30+## [Using](/docs/using)
31+
32+Here live guides that are helpful for everyday users.
33+
34+- [Admin and Operation](/using/admin) is a guide to the basic commands used to interact with your ship.
35+- [Messaging](/using/messaging) tells you how to use Talk, our chat system.
36+- [Shell](/using/shell) is a guide to using Dojo, our command-line interface.
37+- [Introduction to the Filesystem](/using/filesystem) explains the basics of using use Clay, our revision-control filesystem.
38+- [Source Layout](/using/layout) walks you through the various directories of the Arvo operating system.
39+- [Sail](/using/sail) is a guide to Sail: Hoon markup that's used to build web pages with XML.
40+- [Udon](/using/udon) is a guide to Udon, which is our take on Markdown.
41+- [Generators](/using/generators) will explain how to use the "generator," a kind of file that's the easiest way to run Hoon programs.
42+
3043## [Concepts](/docs/concepts)
3144
3245If you're looking for a high-level introduction to the Urbit project and its components, start here.
3346
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 repositories.
39−- [Galaxies, Stars, and Planets](/docs/introduction/galaxies-stars-and-planets), an explanation of the Azimuth address-space hierarchy.
47+- [Arvo vs. Azimuth](/docs/concepts/arvo-vs-azimuth), a quick explanation of the two parallel systems that compose Urbit.
48+- [Technical Overview](/docs/concepts/technical-overview), a more in-depth description of the entire Urbit stack.
49+- [Contributing](/docs/concepts/contributing), a guide to getting involved with the Urbit project.
50+- [Community Tutorials](/docs/concepts/community-tutorials), a collection of unofficial but useful Urbit learning resources.
51+- [Source Code](/docs/concepts/source-code-overview), an explanation of Urbit's constituent GitHub repositories.
52+- [Galaxies, Stars, and Planets](/docs/concepts/galaxies-stars-and-planets), an explanation of the Azimuth address-space hierarchy.
4053
4154## [Learn](/docs/learn)
4255
4356If you're interested in contributing to the project, building applications, or understanding the system technically, take a look at our tutorials and explanations of Urbit's components.
4457
45−- [The Hoon Tutorial](/docs/learn/hoon), for our programming language. To learn the system, start here.
46−- [The Arvo section](/docs/learn/arvo), for the internals of Arvo, Urbit's operating system.
58+- The [Hoon section](/docs/learn/hoon), for resources on learning our programming language. To understand the system, start here.
59+- The [Arvo section](/docs/learn/arvo), for the internals of Arvo, Urbit's operating system.
60+- The [Nock section](/docs/learn/nock), for learning Nock, Urbit's low-level language.
61+- The [Vere section](/docs/learn/vere), for learning about Vere, the virtual machine that runs on Unix.
4762
4863## [Reference](/docs/reference)
4964