on master help sign in
fix broken link and content and contributing
commit86dd4e3f60ea2b52d533ac19c4290f93d2e24a82 authorMorgan Sutherland <morgan@morgansutherland.com> dateMon 1 Jul 2019, 10:34 (7 years ago) parentfbb5126
2 files changed+7−11
getting-started/contributing.md+6−10 using/shell.md+1−1
getting-started/contributing.md+6−10
@@ -5,21 +5,17 @@ template = "doc.html"
55description = "A guide to getting involved with the Urbit project."
66+++
77
8−We accept submissions for improving our [code](https://github.com/urbit/urbit/) and [documentation](https://github.com/urbit/docs/) alike.
8+We welcome submissions for improving our [code](https://github.com/urbit/urbit/) and [documentation](https://github.com/urbit/docs/) alike. If you're looking to get involved, there are a few things you can do to get started right away:
99
10−If you're looking to get involved, there are a few things you can do:
11−
12−- Join the [urbit-dev](https://groups.google.com/a/urbit.org/forum/#!forum/dev) mailing list.
10+- Join the [urbit-dev](https://groups.google.com/a/urbit.org/forum/#!forum/dev) mailing list
1311- [Ask us about Hoon School](mailto:support@urbit.org), a course we run to teach the Hoon programming language and Urbit application development.
1412- Check out the "good contributor issues" tag in the [urbit](https://github.com/urbit/urbit/labels/good%20contributor%20issue) and [arvo](https://github.com/urbit/arvo/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+contributor+issue%22) Github repositories.
15−- Reach out to [support@urbit.org](mailto:support@urbit.org) to say hi and ask any questions you might have.
16−
17−If you're getting set up to work on the Urbit or Arvo code base for the first time, start with our [Getting Started](./docs/getting-started/_index.md) guide, then have a look at [CONTRIBUTING.md](https://github.com/urbit/urbit/blob/master/CONTRIBUTING.md) in the Urbit repository.
13+- Reach out to [support@urbit.org](mailto:support@urbit.org) to say hi and ask any questions you might have. We're always happy to try to point you in the right direction.
1814
19−Many contributors start by contributing to the [documentation](https://github.com/urbit/docs), [urbit.org](https://github.com/urbit/urbit.org), or [bridge](https://github.com/urbit/bridge). If you're not yet comfortable with Hoon, we recommend starting there.
15+Many contributors start by contributing to the [documentation](https://github.com/urbit/docs), [urbit.org](https://github.com/urbit/urbit.org), or [bridge](https://github.com/urbit/bridge) repositories. If you're not yet comfortable with Hoon, we recommend starting there.
2016
21−If smart contracts (Solidity) are more your jam, have a look at [Azimuth](https://github.com/urbit/azimuth), Urbit's identity layer.
17+If you're just getting set up to work on the Urbit or Arvo code base for the first time, see our [Getting Started](./docs/getting-started/_index.md) guide, then have a look at [CONTRIBUTING.md](https://github.com/urbit/urbit/blob/master/CONTRIBUTING.md) in the Urbit repository.
2218
2319## Code style
2420
25−Before contributing Hoon code, you should familiarize yourself with the [Hoon style guide](./docs/learn/hoon/style.md). For a good example of idiomatic Hoon, see [ford.hoon](https://github.com/urbit/arvo/blob/master/sys/vane/ford.hoon).
21+Before contributing Hoon code, you should familiarize yourself with the [Hoon style guide](./docs/learn/hoon/style.md). For a good example of idiomatic Hoon, see [Ford](https://github.com/urbit/arvo/blob/master/sys/vane/ford.hoon).
using/shell.md+1−1
@@ -287,7 +287,7 @@ Which outputs a new `urbit.pill` to `pier/.urb/put/urbit.pill`
287287
288288##### `&` - Mark conversion
289289
290−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/#udon) is converted to `&hymn` (a mark which supplies the `html`, `head`, `body` and closing tags) first, before being converted to HTML:
290+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:
291291
292292```
293293~your-urbit:dojo>&html &hymn &udon ';h1#hello: hello'