@@ -10,7 +10,7 @@
11Welcome 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.
11Welcome 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.
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.
15## [Getting Started](/docs/getting-started)
15## [Getting Started](/docs/getting-started)
@@ -27,23 +27,38 @@ In addition to those primary pages, the documents below are helpful but optional
27- [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.
27- [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.
28- [Operating a Star](/docs/getting-started/creating-a-development-ship)
28- [Operating a Star](/docs/getting-started/creating-a-development-ship)
30+## [Using](/docs/using)
32+Here live guides that are helpful for everyday users.
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.
30## [Concepts](/docs/concepts)
43## [Concepts](/docs/concepts)
32If you're looking for a high-level introduction to the Urbit project and its components, start here.
45If you're looking for a high-level introduction to the Urbit project and its components, start here.
34−- [Arvo vs. Azimuth](/docs/introduction/arvo-vs-azimuth), a quick explanation of the two parallel systems that compose Urbit.
47+- [Arvo vs. Azimuth](/docs/concepts/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.
48+- [Technical Overview](/docs/concepts/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.
49+- [Contributing](/docs/concepts/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.
50+- [Community Tutorials](/docs/concepts/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.
51+- [Source Code](/docs/concepts/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.
52+- [Galaxies, Stars, and Planets](/docs/concepts/galaxies-stars-and-planets), an explanation of the Azimuth address-space hierarchy.
41## [Learn](/docs/learn)
54## [Learn](/docs/learn)
43If 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.
56If 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.
45−- [The Hoon Tutorial](/docs/learn/hoon), for our programming language. To learn the system, start here.
58+- The [Hoon section](/docs/learn/hoon), for resources on learning our programming language. To understand the system, start here.
46−- [The Arvo section](/docs/learn/arvo), for the internals of Arvo, Urbit's operating system.
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.
48## [Reference](/docs/reference)
63## [Reference](/docs/reference)