f3ca521 · urbit.org · git.iko.soy

_index.md+4−8

compare with master

unifiedsplit

@@ -20,16 +20,12 @@ The Operator's Manual will show you how to perform everyday functions on your Ur

20

21This guide will teach you how set up an Urbit development environment.

22

23−## Technical Documentation

23+## Documentation

24

25The 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:

26

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.

28

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.

30

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.

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.

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.

concepts/_index.md+2−4

@@ -1,13 +1,11 @@

1+++

2title = "Concepts"

3−weight = 3

3+weight = 1

4sort_by = "weight"

5template = "sections/docs/chapters.html"

6+++

7−The documents in this section are high-level introductions to the Urbit project and components thereof.

8

7

8+The documents in this section are high-level introductions to the Urbit project and components thereof.

9

10* [Technical Overview](technical-overview): An in-the-weeds explanation of the components of the Urbit stack.

11* [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 @@

1+++

2title = "Azimuth"

3weight = 4

4−template = "doc.html"

4+template = "doc.html"."

5−description = "An explanation of the Urbit identity layer."

5+aliases = ["/docs/learn/azimuth"]

6+++

7Azimuth 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.

8

concepts/technical-overview.md−1

@@ -2,7 +2,6 @@

2title = "Technical overview"

3weight = 1

4template = "doc.html"

5−description = "A more in-depth description of the entire Urbit stack."

6+++

5+++

7Urbit is a clean-slate software stack designed to implement an encrypted P2P

6Urbit is a clean-slate software stack designed to implement an encrypted P2P

8network of general-purpose personal servers. Each server on this network is a

7network of general-purpose personal servers. Each server on this network is a

reference/_index.md+5−1

@@ -1,6 +1,6 @@

1+++

2title = "Reference"

3−weight = 5

3+weight = 3

4sort_by = "weight"

5template = "sections/docs/chapters.html"

6+++

@@ -11,6 +11,10 @@ Various reference documents are stored here, particularly for Hoon, but also for

11Urbit is known for introducing a great deal of new terminology. The glossary will

12help demystify our jargon.

13

14+## [The Azimuth Glossary](@/docs/reference/azimuth-glossary.md)

15+

16+Azimuth, the Urbit identity layer, has its own vocabulary.

17+

14## [The Cheat Sheet](@/docs/reference/cheat-sheet.md)

18## [The Cheat Sheet](@/docs/reference/cheat-sheet.md)

15

19

16The cheat sheet is a compact document for looking up Hoon runes.

20The cheat sheet is a compact document for looking up Hoon runes.

learn/_index.md → tutorials/_index.mdrenamed+3−2

@@ -1,8 +1,9 @@

1+++

2−title = "Learn"

2+title = "Tutorials"

3−weight = 4

3+weight = 2

4sort_by = "weight"

5template = "sections/docs/chapters.html"

6+aliases = ["docs/learn/"]

6+++

7+++

7

8

8Tutorials and explanations for all the components of Urbit.

9Tutorials 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

41- [2.1 Atoms, Auras, and Simple Cell Types](atoms-auras-and-simple-cell-types)

42- [2.2 Type Checking and Type Inference](type-checking-and-type-inference)

43- [2.3 Structures and Complex Types](structures-and-complex-types)

44+- [2.3.1 Walkthrough: Libraries](libraries)

44- [2.4 Standard Library: Trees, Sets, and Maps](trees-sets-and-maps)

45- [2.4 Standard Library: Trees, Sets, and Maps](trees-sets-and-maps)

45- [2.5 Type Polymorphism](type-polymorphism)

46- [2.5 Type Polymorphism](type-polymorphism)

47+- [2.5.1 Walkthrough: Iron Polymorphism](iron-polymorphism)

48+- [2.5.2 Walkthrough: Lead Polymorphism](lead-polymorphism)

46−- [2.7 Gall](gall)

49+- [2.6 Gall](gall)

50+- [2.7.1 Walkthrough: Egg Timer](egg-timer)

51+

47

52

48## Other Resources

53## Other Resources

49

54

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 @@

1+++

2−title = "2.7.1 Gall Walkthrough: Egg Timer"

2+title = "2.6.1 Gall Walkthrough: Egg Timer"

3weight = 36

4template = "doc.html"

5aliases = ["/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 @@

1+++

2−title = "2.7 Gall"

2+title = "2.6 Gall"

3weight = 35

4template = "doc.html"

5aliases = ["/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.

78

79`++sigh` gets called when Eyre has a response to an http request made by our application.

80

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:

574```

575=lead-gate

576```

577−

578−

learn/hoon-tutorial/workbook/_index.md → tutorials/hoon-tutorial/workbook/_index.mdrenamed+1−1

@@ -1,6 +1,6 @@

1+++

2title = "Hoon Workbook"

3−weight = 2

3+weight = 150

4sort_by = "weight"

5template = "sections/docs/chapters.html"

6aliase = ["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.