on master help sign in
refactor docs, step 1
commitebf099d41882e2e316ebbf806685f7b3ed5f0ef8 authorMorgan Sutherland <morgan@morgansutherland.com> dateTue 17 Sep 2019, 15:53 (7 years ago) parent8ebc1bd
2 files changed+13−13
content/faq.md+7−7 content/operations.md+6−6
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
5555
5656### What is a `@p`? Why is my username generated for me? {#what-is-patp}
5757
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.
5959
6060These 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.
6161
@@ -85,7 +85,7 @@ We have seen publicly hosted versions of Bridge online. We strongly recommend av
8585
8686The 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.
8787
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).
8989
9090### What is a master ticket? {#master-ticket}
9191
@@ -199,7 +199,7 @@ All events are logged to disk, so you can always restore the system to a previou
199199
200200When 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.
201201
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.
203203
204204### Will the Arvo network survive if Ethereum dies? {#if-ethereum-dies}
205205
@@ -207,11 +207,11 @@ Yes. It would be annoying, but Azimuth would be ported to another decentralized
207207
208208### How do I install Arvo? {#install-arvo}
209209
210−Check out our guides [here](@/docs/getting-started/_index.md).
210+Check out our guides [here](@/try.md).
211211
212212### How do I use Arvo? {#use-arvo}
213213
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.
215215
216216### How do over-the-air updates work? {#over-the-air-updates}
217217
@@ -223,9 +223,9 @@ Landscape is an experimental Arvo web interface that includes social functions s
223223
224224### I have a point, now what? {#now-what}
225225
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).
227227
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).
229229
230230
231231## Grants
content/operations.md+6−6
@@ -163,7 +163,7 @@ moon: ~faswep-navred-sampel-palnet
163163and does not need editing to be used with the `-k` option.
164164
165165You 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:
167167
168168```
169169$ urbit -w <moonname> -G <key> -c <piername>
@@ -308,7 +308,7 @@ be used for that we haven't even thought of.
308308
309309Here we'll be discussing how to operate the default CLI frontend, Talk,
310310to 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).
312312
313313### Quickstart
314314
@@ -994,7 +994,7 @@ Tall-form Hoon may require multiple lines:
994994~your-urbit:dojo< 2
995995```
996996
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).
998998The Dojo has its own subject, and that's where Hoon's equivalent of variables,
999999called faces, are stored.
10001000
@@ -1016,7 +1016,7 @@ Use `=dir` to set the current working directory:
10161016```
10171017
10181018(`%` 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))
10201020
10211021Generators (files in `/gen`) are run with `+`:
10221022
@@ -1219,7 +1219,7 @@ Apps usually expect marked data, so `&` is often used here.
12191219
12201220#### `*` - Save in `%clay`
12211221
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`:
12231223
12241224```
12251225~your-urbit:dojo> *%/web/foo/udon '# hello'
@@ -1250,7 +1250,7 @@ Which outputs a new `urbit.pill` to `pier/.urb/put/urbit.pill`
12501250
12511251#### `&` - Mark conversion
12521252
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:
12541254
12551255```
12561256~your-urbit:dojo>&html &hymn &udon ';h1#hello: hello'