f906427 · urbit.org · git.iko.soy

concepts/galaxies-stars-and-planets.md+2−1

compare with master

unifiedsplit

@@ -4,9 +4,10 @@ weight = 7

4template = "doc.html"

5description = "An explanation of the Urbit address-space hierarchy. "

6+++

7+

7The current internet has no consistent system of identity. There are only quasi-identities such as IP addresses, Google accounts and email addresses, each able to be assumed and abandoned without much trouble. The result is a hostile social experience, since bad actors -- spammers, scammers, malware-spreaders, and harassers -- have an inexhaustible supply of places to hide.

8The current internet has no consistent system of identity. There are only quasi-identities such as IP addresses, Google accounts and email addresses, each able to be assumed and abandoned without much trouble. The result is a hostile social experience, since bad actors -- spammers, scammers, malware-spreaders, and harassers -- have an inexhaustible supply of places to hide.

8

9

9−That's why we built a system for persistent identity called [Azimuth](./docs/concepts/arvo-vs-azimuth.md). Azimuth identities are called _points_, and you need one to use the Arvo network. Points are secure, since they are owned and controlled with key-pair the Ethereum blockchain, which Azimuth is built on top of.

10+That's why we built a system for persistent identity called [Azimuth](./docs/concepts/azimuth.md). Azimuth identities are called _points_, and you need one to use the Arvo network. Points are secure, since they are owned and controlled with key-pair the Ethereum blockchain, which Azimuth is built on top of.

10

11

11An Azimuth point is a pronounceable string like `~firbyr-napbes`. It means nothing, but it's easy to remember and say out loud. `~firbyr-napbes` is actually just a 32-bit number (`3.237.967.392`, to be exact) that we turn into a human-memorable string.

12An Azimuth point is a pronounceable string like `~firbyr-napbes`. It means nothing, but it's easy to remember and say out loud. `~firbyr-napbes` is actually just a 32-bit number (`3.237.967.392`, to be exact) that we turn into a human-memorable string.

12

13

getting-started/booting-a-ship.md+1−1

@@ -3,7 +3,7 @@ title = "Booting a Ship"

3weight = 3

4template = "doc.html"

5+++

6−Now the rubber meets the road. You'll be booting your ship with the keyfile that you [downloaded from Bridge](./docs/concepts/azimuth/_index.md).

6+Now the rubber meets the road. You'll be booting your ship with the keyfile that you [downloaded from Bridge](./docs/concepts/azimuth.md).

7

8Note that this document is only for booting a ship that uses the live Arvo network. If you just want to create an unnetworked ship for development purposes, read [this guide](./docs/getting-started/creating-a-development-ship.md) instead.

9

getting-started/using-bridge.md+2−1

@@ -3,7 +3,8 @@ title = "Using Bridge"

3weight = 1

4template = "doc.html"

5+++

6+

6−[Bridge](https://github.com/urbit/bridge) is the client we built for interacting with [Azimuth](./docs/concepts/azimuth/_index.md), the Urbit PKI, and managing your Azimuth identities, called _points_. Importantly, Bridge also allows you to generate a keyfile that you will need to boot your ship so that it can use the Arvo network.

7+[Bridge](https://github.com/urbit/bridge) is the client we built for interacting with [Azimuth](./docs/concepts/azimuth.md), the Urbit PKI, and managing your Azimuth identities, called _points_. Importantly, Bridge also allows you to generate a keyfile that you will need to boot your ship so that it can use the Arvo network.

7

8

8This guide assumes that you own an Azimuth point, or that you have found someone to send an Azimuth point to your Ethereum address and are looking to claim it.

9This guide assumes that you own an Azimuth point, or that you have found someone to send an Azimuth point to your Ethereum address and are looking to claim it.

9

10

learn/hoon/hoon-tutorial/_index.md+1−1

@@ -47,7 +47,7 @@ The first three lessons take you through a simple Hoon program, explain Hoon's s

47

48Consult the [Reference section](./docs/reference/_index.md) to look up any unknown rune or standard library function you don't understand.

49

50−As you work your way through these lessons you may want to work on example problems from the [Hoon Workbook](./docs/learn/hoon/workbook/_index.md) for practice. Once you finish the lessons here you may want to write more versatile Hoon programs which can make use of more of your urbit's environment, in which case you'll want to check out the [Generators](./docs/using/generators.md) documentation. Or maybe you'd like to learn how to write a [Gall app](content/docs/learn/arvo/gall.md). Learn about [Udon](./docs/using/udon.md), Urbit's stripped-down version of Markdown. Or learn [Sail](./docs/using/sail.md), a subset of Hoon used for generating XML nodes.

50+As you work your way through these lessons you may want to work on example problems from the [Hoon Workbook](./docs/learn/hoon/workbook/_index.md) for practice. Once you finish the lessons here you may want to write more versatile Hoon programs which can make use of more of your urbit's environment, in which case you'll want to check out the [Generators](./docs/using/generators.md) documentation. Or maybe you'd like to learn how to write a [Gall app](content/docs/learn/arvo/gall.md). Learn about [Udon](./docs/using/sail-and-udon.md), Urbit's stripped-down version of Markdown. Or learn [Sail](./docs/using/sail-and-udon.md), a subset of Hoon used for generating XML nodes.

51

52

53> Last major revision of this section: February 2019

reference/hoon-expressions/rune/mic.md+4−3

@@ -3,6 +3,7 @@ title = "Make"

3weight = 13

4template = "doc.html"

5+++

6+

6Miscellaneous useful macros.

7Miscellaneous useful macros.

7

8

8## Runes

9## Runes

@@ -79,7 +80,7 @@ A `marl`, i.e., a list of `manx`. A `manx` is a noun that represents a single X

79

80

80tl;dr -- `;+` converts a `manx` to a `marl`.

81tl;dr -- `;+` converts a `manx` to a `marl`.

81

82

82−`;+` is a Sail rune. Sail is a part of Hoon used for creating and operating on nouns that represent XML nodes. With the appropriate rendering pipeline, a Sail document can be used to generate a static website. See the [Sail tutorial](./docs/using/sail.md).

83+`;+` is a Sail rune. Sail is a part of Hoon used for creating and operating on nouns that represent XML nodes. With the appropriate rendering pipeline, a Sail document can be used to generate a static website. See the [Sail tutorial](./docs/using/sail-and-udon.md).

83

84

84In Sail a single XML node is represented by a `manx`. A single `<p>` node `manx` can be produced in the following way:

85In Sail a single XML node is represented by a `manx`. A single `<p>` node `manx` can be produced in the following way:

85

86

@@ -293,7 +294,7 @@ A `marl`, i.e., a list of `manx`. A `manx` is a noun that represents a single X

293

294

294##### Discussion

295##### Discussion

295

296

296−`;*` is a Sail rune. Sail is a part of Hoon used for creating and operating on nouns that represent XML nodes. With the appropriate rendering pipeline, a Sail document can be used to generate a static website. See the [Sail tutorial](./docs/using/sail.md).

297+`;*` is a Sail rune. Sail is a part of Hoon used for creating and operating on nouns that represent XML nodes. With the appropriate rendering pipeline, a Sail document can be used to generate a static website. See the [Sail tutorial](./docs/using/sail-and-udon.md).

297

298

298If you need a complex Hoon expression to produce a `marl`, use the `;*` rune. Often this rune is used with an expression, `p`, that includes one or more `;=` subexpressions.

299If you need a complex Hoon expression to produce a `marl`, use the `;*` rune. Often this rune is used with an expression, `p`, that includes one or more `;=` subexpressions.

299

300

@@ -345,7 +346,7 @@ A `marl`, i.e., a list of `manx`. A `manx` is a noun that represents a single X

345

346

346##### Discussion

347##### Discussion

347

348

348−`;=` is a Sail rune. Sail is a part of Hoon used for creating and operating on nouns that represent XML nodes. With the appropriate rendering pipeline, a Sail document can be used to generate a static website. See the [Sail tutorial](./docs/using/sail.md).

349+`;=` is a Sail rune. Sail is a part of Hoon used for creating and operating on nouns that represent XML nodes. With the appropriate rendering pipeline, a Sail document can be used to generate a static website. See the [Sail tutorial](./docs/using/sail-and-udon.md).

349

350

350In Sail a single XML node is represented by a `manx`. A single `<p>` node `manx` can be produced in the following way:

351In Sail a single XML node is represented by a `manx`. A single `<p>` node `manx` can be produced in the following way:

351

352

using/_index.md+1−2

@@ -11,6 +11,5 @@ This section contains guides to using your urbit.

11- [Shell](./docs/using/shell.md) is a guide to using Dojo, our command-line interface.

12- [Introduction to the Filesystem](./docs/using/filesystem.md) explains the basics of using use Clay, our revision-control filesystem.

13- [Source Layout](./docs/using/layout.md) walks you through the various directories of the Arvo operating system.

14−- [Sail](./docs/using/sail.md) is a guide to Sail: Hoon markup that's used to build web pages with XML.

14+- [Sail and Udon](./docs/using/sail-and-udon.md) is a guide to Sail: Hoon markup that's used to build web pages with XML and Udon, which is our take on Markdown.

15−- [Udon](./docs/using/udon.md) is a guide to Udon, which is our take on Markdown.

16- [Generators](./docs/using/generators.md) will explain how to use the "generator," a kind of file that's the easiest way to run Hoon programs.

15- [Generators](./docs/using/generators.md) will explain how to use the "generator," a kind of file that's the easiest way to run Hoon programs.

using/admin.md+1−1

@@ -164,7 +164,7 @@ moon: ~faswep-navred-sampel-palnet

164and does not need editing to be used with the `-k` option.

165

166You can use the resulting output in the same installation flow from the

167−[Booting a Ship](./docs/getting-started/booting-a-ship/) guide, following the same scheme as for booting a planet. That scheme is:

167+[Booting a Ship](./docs/getting-started/booting-a-ship.md) guide, following the same scheme as for booting a planet. That scheme is:

168

169```

170$ urbit -w <moonname> -G <key> -c <piername>

using/shell.md+1−1

@@ -256,7 +256,7 @@ Apps usually expect marked data, so `&` is often used here.

256

257##### `*` - Save in `%clay`

258

259−Save a new `.udon` ([Udon](./docs/using/udon.md)) file in `web`:

259+Save a new `.udon` ([Udon](./docs/using/sail-and-udon.md)) file in `web`:

260

261```

262~your-urbit:dojo> *%/web/foo/udon '# hello'