on master help sign in
improve arvo index styling
a6301d9Josh Lehman
arvo/_index.md+20−27
@@ -6,57 +6,50 @@ template = "sections/docs/chapters.html"
6aliases = ["/docs/learn/arvo/"]
6aliases = ["/docs/learn/arvo/"]
7+++
7+++
8
8
9+Resources about the Urbit OS.
9
10
10−## [Arvo](@/docs/arvo/overview.md)
11+## [Overview](@/docs/arvo/overview.md)
11
12
12−Arvo is Urbit's functional operating system, written in [Hoon](@/docs/hoon/hoon-school/_index.md). It's composed of modules called _vanes_:
13+Arvo is Urbit's functional operating system, written in [Hoon](@/docs/hoon/hoon-school/_index.md). It's composed of modules called _vanes_, each of which has its own folder:
13
14
14−
15−## Tutorials
16−
17−### [Move Trace](@/docs/arvo/tutorials/move-trace.md)
18−
19−A walkthrough of what the Arvo kernel does to respond to a simple command.
20−
21−
22−## Concepts
23−
24−### [Input/Output](@/docs/arvo/concepts/io.md)
25−
26−Conceptual overview of how Arvo handles input and output.
27−
28−
29−## Vanes
30−
31−### [Ames](@/docs/arvo/ames/ames.md)
15+## [Ames](@/docs/arvo/ames/ames.md)
32
16
33Ames is the name of our network and the vane that communicates over it. It's an encrypted P2P network composed of instances of the Arvo operating system.
17Ames is the name of our network and the vane that communicates over it. It's an encrypted P2P network composed of instances of the Arvo operating system.
34
18
35−### [Behn](@/docs/arvo/behn/behn.md)
19+## [Behn](@/docs/arvo/behn/behn.md)
36
20
37Behn is our timer. It allows vanes and applications to set and timer events, which are managed in a simple priority queue.
21Behn is our timer. It allows vanes and applications to set and timer events, which are managed in a simple priority queue.
38
22
39−### [Clay](@/docs/arvo/clay/clay.md)
23+## [Clay](@/docs/arvo/clay/clay.md)
40
24
41Clay is our filesystem and revision-control system.
25Clay is our filesystem and revision-control system.
42
26
43−### [Dill](@/docs/arvo/dill/dill.md)
27+## [Dill](@/docs/arvo/dill/dill.md)
44
28
45Dill is our terminal driver. Unix sends keyboard events to dill from the terminal, and dill produces terminal output.
29Dill is our terminal driver. Unix sends keyboard events to dill from the terminal, and dill produces terminal output.
46
30
47−### [Eyre](@/docs/arvo/eyre/eyre.md)
31+## [Eyre](@/docs/arvo/eyre/eyre.md)
48
32
49Eyre is our HTTP server. Unix sends HTTP messages to `%eyre`, and `%eyre` produces HTTP messages in response.
33Eyre is our HTTP server. Unix sends HTTP messages to `%eyre`, and `%eyre` produces HTTP messages in response.
50
34
51−### [Ford](@/docs/arvo/ford/ford.md)
35+## [Ford](@/docs/arvo/ford/ford.md)
52
36
53Ford is our build system. It handles resources and publishing.
37Ford is our build system. It handles resources and publishing.
54
38
55−### [Gall](@/docs/arvo/gall/gall.md)
39+## [Gall](@/docs/arvo/gall/gall.md)
56
40
57Gall is the vane for controlling userspace apps.
41Gall is the vane for controlling userspace apps.
58
42
59−### Iris
43+## [Iris](@/docs/arvo/iris/iris-api.md)
60
44
61Iris is our HTTP client.
45Iris is our HTTP client.
62
46
47+## [Concepts](@/docs/arvo/concepts/_index.md)
48+
49+Explanations of design decisions that are pervasive throughout Arvo.
50+
51+## [Tutorials](@/docs/arvo/tutorials/_index.md)
52+
53+Walkthroughs that teach you more about how Arvo works.
54+
55+
arvo/concepts/_index.md+8
@@ -6,3 +6,11 @@ template = "sections/docs/chapters.html"
6+++
6+++
7
7
8Other concepts related to the way Arvo works.
8Other concepts related to the way Arvo works.
9+
10+## [Input and Output](@/docs/arvo/concepts/io.md)
11+
12+Styles if IO you'll encounter in Urbit.
13+
14+## [Subscriptions](@/docs/arvo/concepts/subscriptions.md)
15+
16+Urbit relies heavily on subscriptions throughout the stack. We strongly prefer reactive data flow compared to querying or polling, which is why for example our equivalent to git natively supports subscriptions to its data.