on master help sign in
refactor docs, step 1
ebf099dMorgan Sutherland
content/faq.md+7−7
@@ -55,7 +55,7 @@ Comets are 128 bits and have no parents. They can be launched by anyone. They ar
55
55
56### What is a `@p`? Why is my username generated for me? {#what-is-patp}
56### What is a `@p`? Why is my username generated for me? {#what-is-patp}
57
57
58−A `@p` (pronounced *pat-pee*) is a name like `~zod` or `~lodleb-ritrul` composed of pronounceable, three-letter phonemic elements like `zod`, `lod`, `leb`, `rit` and `rul`. Shorter names, such as `~zod` and `~marzod`, are assigned to ships with special duties on the Arvo network ([stars and galaxies](@/docs/concepts/galaxies-stars-and-planets.md), respectively. Longer names like `~palfun-foslup` are identities for typical users.
58+A `@p` (pronounced *pat-pee*) is a name like `~zod` or `~lodleb-ritrul` composed of pronounceable, three-letter phonemic elements like `zod`, `lod`, `leb`, `rit` and `rul`. Shorter names, such as `~zod` and `~marzod`, are assigned to ships with special duties on the Arvo network stars and galaxies, respectively. Longer names like `~palfun-foslup` are identities for typical users.
59
59
60These names map directly to a corresponding number in the urbit address space. Galaxies occupy the 8-bit address space, so any galaxy is actually a number between zero and 255. Stars occupy the 16-bit address space, and planets occupy the 32-bit address space.
60These names map directly to a corresponding number in the urbit address space. Galaxies occupy the 8-bit address space, so any galaxy is actually a number between zero and 255. Stars occupy the 16-bit address space, and planets occupy the 32-bit address space.
61
61
@@ -85,7 +85,7 @@ We have seen publicly hosted versions of Bridge online. We strongly recommend av
85
85
86The Urbit Hierarchical Deterministic (HD) Wallet is a custom Ethereum wallet based on BIP39 and BIP44 – the same underlying technology used by wallet providers like Ledger, Trezor, Metamask, and MyEtherWallet. You can think of the Urbit HD wallet as a wallet of wallets, which lets you keep a single passphrase for all of your Azimuth keys. Azimuth uses multiple keys with different capabilities – a bit like permissions – so that you can keep the more valuable keys in cold storage while keeping less valuable keys, used in day-to-day operation, more easily accessible. If you're only operating a planet, you shouldn't have to worry about this: you can simply think of your "master ticket" as the password to your Azimuth point. If you're operating a star or galaxy, the Urbit HD Wallet allows you to implement a multi-tier key custody scheme.
86The Urbit Hierarchical Deterministic (HD) Wallet is a custom Ethereum wallet based on BIP39 and BIP44 – the same underlying technology used by wallet providers like Ledger, Trezor, Metamask, and MyEtherWallet. You can think of the Urbit HD wallet as a wallet of wallets, which lets you keep a single passphrase for all of your Azimuth keys. Azimuth uses multiple keys with different capabilities – a bit like permissions – so that you can keep the more valuable keys in cold storage while keeping less valuable keys, used in day-to-day operation, more easily accessible. If you're only operating a planet, you shouldn't have to worry about this: you can simply think of your "master ticket" as the password to your Azimuth point. If you're operating a star or galaxy, the Urbit HD Wallet allows you to implement a multi-tier key custody scheme.
87
87
88−To learn about the specifics, check out our [HD Wallet documentation](@/docs/concepts/azimuth.md#the-urbit-hd-wallet) and the [Urbit HD Wallet Spec (UP 8)](https://github.com/urbit/proposals/blob/master/008-urbit-hd-wallet.md).
88+The [Urbit HD Wallet Spec (UP 8)](https://github.com/urbit/proposals/blob/master/008-urbit-hd-wallet.md).
89
89
90### What is a master ticket? {#master-ticket}
90### What is a master ticket? {#master-ticket}
91
91
@@ -199,7 +199,7 @@ All events are logged to disk, so you can always restore the system to a previou
199
199
200When an Arvo ship (instance) is started for the first time, you must use a "keyfile" containing the private keys for your Azimuth point's networking keys. Azimuth uses the Ethereum blockchain as its decentralized ledger.
200When an Arvo ship (instance) is started for the first time, you must use a "keyfile" containing the private keys for your Azimuth point's networking keys. Azimuth uses the Ethereum blockchain as its decentralized ledger.
201
201
202−See our [Getting Started](@/docs/getting-started/_index.md) guide to learn how to get your ship onto the Arvo network.
202+See our [Getting Started](@/try.md) guide to learn how to get your ship onto the Arvo network.
203
203
204### Will the Arvo network survive if Ethereum dies? {#if-ethereum-dies}
204### Will the Arvo network survive if Ethereum dies? {#if-ethereum-dies}
205
205
@@ -207,11 +207,11 @@ Yes. It would be annoying, but Azimuth would be ported to another decentralized
207
207
208### How do I install Arvo? {#install-arvo}
208### How do I install Arvo? {#install-arvo}
209
209
210−Check out our guides [here](@/docs/getting-started/_index.md).
210+Check out our guides [here](@/try.md).
211
211
212### How do I use Arvo? {#use-arvo}
212### How do I use Arvo? {#use-arvo}
213
213
214−The [Using](@/docs/using/_index.md) section of the documentation will help you out.
214+The [Using](@/operations.md) section of the documentation will help you out.
215
215
216### How do over-the-air updates work? {#over-the-air-updates}
216### How do over-the-air updates work? {#over-the-air-updates}
217
217
@@ -223,9 +223,9 @@ Landscape is an experimental Arvo web interface that includes social functions s
223
223
224### I have a point, now what? {#now-what}
224### I have a point, now what? {#now-what}
225
225
226−Follow our guide on how to boot a ship [here](@/docs/getting-started/booting-a-ship.md).
226+Follow our guide on how to boot a ship [here](@/try.md).
227
227
228−Get on the [mailing list](/../#mc_embed_signup). Learn [Hoon](@/docs/learn/hoon/_index.md). Sign up for [Hoon School](@/hoonschool.md). [Make stuff](@/docs/getting-started/contributing.md).
228+Get on the [mailing list](/../#mc_embed_signup). Learn [Hoon](@/docs/hoon/_index.md). Sign up for [Hoon School](@/hoonschool.md). [Make stuff](@/try.md).
229
229
230
230
231## Grants
231## Grants
content/operations.md+6−6
@@ -163,7 +163,7 @@ moon: ~faswep-navred-sampel-palnet
163and does not need editing to be used with the `-k` option.
163and does not need editing to be used with the `-k` option.
164
164
165You can use the resulting output in the same installation flow from the
165You can use the resulting output in the same installation flow from the
166−[Booting a Ship](@/docs/getting-started/booting-a-ship.md) guide, following the same scheme as for booting a planet. That scheme is:
166+[Booting a Ship](@/try.md) guide, following the same scheme as for booting a planet. That scheme is:
167
167
168```
168```
169$ urbit -w <moonname> -G <key> -c <piername>
169$ urbit -w <moonname> -G <key> -c <piername>
@@ -308,7 +308,7 @@ be used for that we haven't even thought of.
308
308
309Here we'll be discussing how to operate the default CLI frontend, Talk,
309Here we'll be discussing how to operate the default CLI frontend, Talk,
310to send and receive messages. For a more in-depth look at Hall's internals,
310to send and receive messages. For a more in-depth look at Hall's internals,
311−take a look at its [documentation](@/docs/learn/arvo/hall.md).
311+take a look at its [documentation](@/docs/arvo/hall.md).
312
312
313### Quickstart
313### Quickstart
314
314
@@ -994,7 +994,7 @@ Tall-form Hoon may require multiple lines:
994~your-urbit:dojo< 2
994~your-urbit:dojo< 2
995```
995```
996
996
997−Hoon uses something called [the subject](@/docs/learn/hoon/hoon-tutorial/the-subject-and-its-legs.md).
997+Hoon uses something called [the subject](@/docs/hoon/hoon-tutorial/the-subject-and-its-legs.md).
998The Dojo has its own subject, and that's where Hoon's equivalent of variables,
998The Dojo has its own subject, and that's where Hoon's equivalent of variables,
999called faces, are stored.
999called faces, are stored.
1000
1000
@@ -1016,7 +1016,7 @@ Use `=dir` to set the current working directory:
1016```
1016```
1017
1017
1018(`%` represents your current directory. For a complete explanation on urbit
1018(`%` represents your current directory. For a complete explanation on urbit
1019−paths, see the [filesystem section](@/docs/using/filesystem.md))
1019+paths, see the [filesystem section](@/operations.md))
1020
1020
1021Generators (files in `/gen`) are run with `+`:
1021Generators (files in `/gen`) are run with `+`:
1022
1022
@@ -1219,7 +1219,7 @@ Apps usually expect marked data, so `&` is often used here.
1219
1219
1220#### `*` - Save in `%clay`
1220#### `*` - Save in `%clay`
1221
1221
1222−Save a new `.udon` ([Udon](@/docs/using/sail-and-udon.md)) file in `web`:
1222+Save a new `.udon` ([Udon](@/docs/arvo/sail-and-udon.md)) file in `web`:
1223
1223
1224```
1224```
1225~your-urbit:dojo> *%/web/foo/udon '# hello'
1225~your-urbit:dojo> *%/web/foo/udon '# hello'
@@ -1250,7 +1250,7 @@ Which outputs a new `urbit.pill` to `pier/.urb/put/urbit.pill`
1250
1250
1251#### `&` - Mark conversion
1251#### `&` - Mark conversion
1252
1252
1253−Convert between marks using `&`, with the destination mark first. You can stack multiple mark conversions together, and some marks can only be converted to specific other marks. In this example, [Udon](@/docs/using/sail-and-udon.md#udon) is converted to `&hymn` (a mark which supplies the `html`, `head`, `body` and closing tags) first, before being converted to HTML:
1253+Convert between marks using `&`, with the destination mark first. You can stack multiple mark conversions together, and some marks can only be converted to specific other marks. In this example, [Udon](@/docs/arvo/sail-and-udon.md#udon) is converted to `&hymn` (a mark which supplies the `html`, `head`, `body` and closing tags) first, before being converted to HTML:
1254
1254
1255```
1255```
1256~your-urbit:dojo>&html &hymn &udon ';h1#hello: hello'
1256~your-urbit:dojo>&html &hymn &udon ';h1#hello: hello'