further structure changes
commitf3ca521c3a58ec19734dbf9b60be3ff9495b1771
authorRobert <robert@Roberts-MacBook-Pro.local>
dateThu 10 Oct 2019, 11:59 (7 years ago)
parentd41a2f4
_index.md+4−8
@@ -20,16 +20,12 @@ The Operator's Manual will show you how to perform everyday functions on your Ur
2020
2121This guide will teach you how set up an Urbit development environment.
2222
23−## Technical Documentation
23+## Documentation
2424
2525The 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:
2626
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.
27+- [Concepts](concepts) gives an in-depth, high-level explanations of Urbit concepts.
2828
29−- [Azimuth](../azimuth) is the Urbit identity layer. To use Urbit, you need an identity that is secured by Azimuth.
29+- [Tutorials](tutorials) contains tutorials all the details about the system, enough where you can develop on Urbit. There are sections on Arvo, the Urbit OS; Hoon, Urbit's functional programming language; Nock, the the low-level language Hoon compiles to; and Vere, the Nock interpreter that acts as the layer between Urbit and whatever system (MacOS, Linux, BSD) is running it.
3030
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.
32−
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.
34−
35−- [Vere](../vere) is the Nock interpreter that acts as the layer between Urbit and whatever system (MacOS, Linux, BSD) is running it.
31+- [Reference](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.
concepts/_index.md+2−4
@@ -1,13 +1,11 @@
11+++
22title = "Concepts"
3−weight = 3
3+weight = 1
44sort_by = "weight"
55template = "sections/docs/chapters.html"
66+++
7−The documents in this section are high-level introductions to the Urbit project and components thereof.
87
8+The documents in this section are high-level introductions to the Urbit project and components thereof.
99
1010* [Technical Overview](technical-overview): An in-the-weeds explanation of the components of the Urbit stack.
1111* [Azimuth](azimuth): An overview of Azimuth, the Urbit identity layer.
12−* [Galaxies, Stars, and Planets](galaxies-stars-and-planets): A guide to the Urbit network hierarchy.
13−* [Community Tutorials](community-tutorials): A collection of community guides for various pieces of the project.
concepts/azimuth.md+2−2
@@ -1,8 +1,8 @@
11+++
22title = "Azimuth"
33weight = 4
4−template = "doc.html"
5−description = "An explanation of the Urbit identity layer."
4+template = "doc.html"."
5+aliases = ["/docs/learn/azimuth"]
66+++
77Azimuth is a general-purpose public-key infrastructure (PKI) on the Ethereum blockchain, used as a platform for Urbit identities that we call _points_. You need a point to use the Arvo network.
88
concepts/technical-overview.md−1
@@ -2,7 +2,6 @@
22title = "Technical overview"
33weight = 1
44template = "doc.html"
5−description = "A more in-depth description of the entire Urbit stack."
65+++
76Urbit is a clean-slate software stack designed to implement an encrypted P2P
87network of general-purpose personal servers. Each server on this network is a
reference/_index.md+5−1
@@ -1,6 +1,6 @@
11+++
22title = "Reference"
3−weight = 5
3+weight = 3
44sort_by = "weight"
55template = "sections/docs/chapters.html"
66+++
@@ -11,6 +11,10 @@ Various reference documents are stored here, particularly for Hoon, but also for
1111Urbit is known for introducing a great deal of new terminology. The glossary will
1212help demystify our jargon.
1313
14+## [The Azimuth Glossary](@/docs/reference/azimuth-glossary.md)
15+
16+Azimuth, the Urbit identity layer, has its own vocabulary.
17+
1418## [The Cheat Sheet](@/docs/reference/cheat-sheet.md)
1519
1620The cheat sheet is a compact document for looking up Hoon runes.
learn/_index.md → tutorials/_index.mdrenamed+3−2
@@ -1,8 +1,9 @@
11+++
2−title = "Learn"
3−weight = 4
2+title = "Tutorials"
3+weight = 2
44sort_by = "weight"
55template = "sections/docs/chapters.html"
6+aliases = ["docs/learn/"]
67+++
78
89Tutorials and explanations for all the components of Urbit.
learn/arvo/_index.md → tutorials/arvo/_index.mdrenamed
The content is the same.
learn/arvo/ames.md → tutorials/arvo/ames.mdrenamed
The content is the same.
learn/arvo/behn.md → tutorials/arvo/behn.mdrenamed
The content is the same.
learn/arvo/clay.md → tutorials/arvo/clay.mdrenamed
The content is the same.
learn/arvo/dill.md → tutorials/arvo/dill.mdrenamed
The content is the same.
learn/arvo/eyre.md → tutorials/arvo/eyre.mdrenamed
The content is the same.
learn/arvo/ford.md → tutorials/arvo/ford.mdrenamed
The content is the same.
learn/arvo/gall.md → tutorials/arvo/gall.mdrenamed
The content is the same.
learn/arvo/glossary.md → tutorials/arvo/glossary.mdrenamed
The content is the same.
learn/hoon-tutorial/_index.md → tutorials/hoon-tutorial/_index.mdrenamed+6−1
@@ -41,9 +41,14 @@ Chapter 2 covers the type system, and writing apps, and the workings of the Arvo
4141- [2.1 Atoms, Auras, and Simple Cell Types](atoms-auras-and-simple-cell-types)
4242- [2.2 Type Checking and Type Inference](type-checking-and-type-inference)
4343- [2.3 Structures and Complex Types](structures-and-complex-types)
44+- [2.3.1 Walkthrough: Libraries](libraries)
4445- [2.4 Standard Library: Trees, Sets, and Maps](trees-sets-and-maps)
4546- [2.5 Type Polymorphism](type-polymorphism)
46−- [2.7 Gall](gall)
47+- [2.5.1 Walkthrough: Iron Polymorphism](iron-polymorphism)
48+- [2.5.2 Walkthrough: Lead Polymorphism](lead-polymorphism)
49+- [2.6 Gall](gall)
50+- [2.7.1 Walkthrough: Egg Timer](egg-timer)
51+
4752
4853## Other Resources
4954
learn/hoon-tutorial/ackermann.md → tutorials/hoon-tutorial/ackermann.mdrenamed
The content is the same.
learn/hoon-tutorial/arms-and-cores.md → tutorials/hoon-tutorial/arms-and-cores.mdrenamed
The content is the same.
learn/hoon-tutorial/atoms-auras-and-simple-cell-types.md → tutorials/hoon-tutorial/atoms-auras-and-simple-cell-types.mdrenamed
The content is the same.
learn/hoon-tutorial/bank-account.md → tutorials/hoon-tutorial/bank-account.mdrenamed
The content is the same.
learn/hoon-tutorial/caesar.md → tutorials/hoon-tutorial/caesar.mdrenamed
The content is the same.
learn/hoon-tutorial/conditionals.md → tutorials/hoon-tutorial/conditionals.mdrenamed
The content is the same.
learn/hoon-tutorial/doors.md → tutorials/hoon-tutorial/doors.mdrenamed
The content is the same.
learn/hoon-tutorial/egg-timer.md → tutorials/hoon-tutorial/egg-timer.mdrenamed+1−1
@@ -1,5 +1,5 @@
11+++
2−title = "2.7.1 Gall Walkthrough: Egg Timer"
2+title = "2.6.1 Gall Walkthrough: Egg Timer"
33weight = 36
44template = "doc.html"
55aliases = ["/docs/learn/hoon/hoon-tutorial/egg-timer/"]
learn/hoon-tutorial/fibonacci.md → tutorials/hoon-tutorial/fibonacci.mdrenamed
The content is the same.
learn/hoon-tutorial/gall.md → tutorials/hoon-tutorial/gall.mdrenamed+2−2
@@ -1,5 +1,5 @@
11+++
2−title = "2.7 Gall"
2+title = "2.6 Gall"
33weight = 35
44template = "doc.html"
55aliases = ["/docs/learn/hoon/hoon-tutorial/gall/"]
@@ -78,4 +78,4 @@ Many arms, `++poke` included, have variants that end in the name of a mark e.g.
7878
7979`++sigh` gets called when Eyre has a response to an http request made by our application.
8080
81−Let's take a look in the next section at an example Gall app.
81+Let's take a look in the next section at an example Gall app.
learn/hoon-tutorial/gates.md → tutorials/hoon-tutorial/gates.mdrenamed
The content is the same.
learn/hoon-tutorial/generators.md → tutorials/hoon-tutorial/generators.mdrenamed
The content is the same.
learn/hoon-tutorial/hoon-syntax.md → tutorials/hoon-tutorial/hoon-syntax.mdrenamed
The content is the same.
learn/hoon-tutorial/iron-polymorphism.md → tutorials/hoon-tutorial/iron-polymorphism.mdrenamed
The content is the same.
learn/hoon-tutorial/lead-polymorphism.md → tutorials/hoon-tutorial/lead-polymorphism.mdrenamed
The content is the same.
learn/hoon-tutorial/libraries.md → tutorials/hoon-tutorial/libraries.mdrenamed
The content is the same.
learn/hoon-tutorial/list-of-numbers.md → tutorials/hoon-tutorial/list-of-numbers.mdrenamed
The content is the same.
learn/hoon-tutorial/lists.md → tutorials/hoon-tutorial/lists.mdrenamed
The content is the same.
learn/hoon-tutorial/molds.md → tutorials/hoon-tutorial/molds.mdrenamed
The content is the same.
learn/hoon-tutorial/nouns.md → tutorials/hoon-tutorial/nouns.mdrenamed
The content is the same.
learn/hoon-tutorial/recursion.md → tutorials/hoon-tutorial/recursion.mdrenamed
The content is the same.
learn/hoon-tutorial/setup.md → tutorials/hoon-tutorial/setup.mdrenamed
The content is the same.
learn/hoon-tutorial/structures-and-complex-types.md → tutorials/hoon-tutorial/structures-and-complex-types.mdrenamed
The content is the same.
learn/hoon-tutorial/style.md → tutorials/hoon-tutorial/style.mdrenamed
The content is the same.
learn/hoon-tutorial/the-subject-and-its-legs.md → tutorials/hoon-tutorial/the-subject-and-its-legs.mdrenamed
The content is the same.
learn/hoon-tutorial/trees-sets-and-maps.md → tutorials/hoon-tutorial/trees-sets-and-maps.mdrenamed
The content is the same.
learn/hoon-tutorial/type-checking-and-type-inference.md → tutorials/hoon-tutorial/type-checking-and-type-inference.mdrenamed
The content is the same.
learn/hoon-tutorial/type-polymorphism.md → tutorials/hoon-tutorial/type-polymorphism.mdrenamed−2
@@ -574,5 +574,3 @@ Once more let's clear up the dojo subject:
574574```
575575=lead-gate
576576```
577−
578−
learn/hoon-tutorial/workbook/_index.md → tutorials/hoon-tutorial/workbook/_index.mdrenamed+1−1
@@ -1,6 +1,6 @@
11+++
22title = "Hoon Workbook"
3−weight = 2
3+weight = 150
44sort_by = "weight"
55template = "sections/docs/chapters.html"
66aliase = ["docs/learn/hoon/workbook/"]
learn/hoon-tutorial/workbook/bomb.md → tutorials/hoon-tutorial/workbook/bomb.mdrenamed
The content is the same.
learn/hoon-tutorial/workbook/digits.md → tutorials/hoon-tutorial/workbook/digits.mdrenamed
The content is the same.
learn/hoon-tutorial/workbook/eightball.md → tutorials/hoon-tutorial/workbook/eightball.mdrenamed
The content is the same.
learn/hoon-tutorial/workbook/traffic-light.md → tutorials/hoon-tutorial/workbook/traffic-light.mdrenamed
The content is the same.
learn/nock/_index.md → tutorials/nock/_index.mdrenamed
The content is the same.
learn/nock/definition.md → tutorials/nock/definition.mdrenamed
The content is the same.
learn/nock/example.md → tutorials/nock/example.mdrenamed
The content is the same.
learn/nock/explanation.md → tutorials/nock/explanation.mdrenamed
The content is the same.
learn/nock/implementations.md → tutorials/nock/implementations.mdrenamed
The content is the same.
learn/sail-and-udon.md → tutorials/sail-and-udon.mdrenamed
The content is the same.
learn/ship-troubleshooting.md → tutorials/ship-troubleshooting.mdrenamed
The content is the same.
learn/vere/_index.md → tutorials/vere/_index.mdrenamed
The content is the same.
learn/vere/api.md → tutorials/vere/api.mdrenamed
The content is the same.
learn/vere/c.md → tutorials/vere/c.mdrenamed
The content is the same.
learn/vere/jetting.md → tutorials/vere/jetting.mdrenamed
The content is the same.
learn/vere/nouns.md → tutorials/vere/nouns.mdrenamed
The content is the same.
learn/vere/runtime.md → tutorials/vere/runtime.mdrenamed
The content is the same.