Merge remote-tracking branch 'origin/master' into philip/aquarium

README.md

@@ -0,0 +1,64 @@
+# Arvo
+
+A clean-slate operating system.
+
+## Usage
+
+To run Arvo, you'll need [Urbit](https://github.com/urbit/urbit/). To install Urbit and run Arvo please follow the instructions in the [getting started docs](https://urbit.org/docs/getting-started/). You'll be on the live network in a few minutes.
+
+If you're doing development on Arvo, keep reading.
+
+## Documentation
+
+Find Arvo's documentation [on urbit.org](https://urbit.org/docs/learn/arvo/).
+
+## Development
+
+To boot a fake ship from your development files, run `urbit` with the following arguments:
+
+```
+urbit -F zod -A /path/to/arvo -c fakezod
+```
+
+Mount Arvo's filesystem allows you to update its contents through Unix. To do so, run `|mount` in dojo. It is most common to `|mount /=home=`.
+
+To create a custom pill (bootstrapping object) from the files loaded into the home desk, run `.my/pill +solid`. Your pill will appear in `/path/to/fakezod/.urb/put/my.pill`.
+
+To boot a fake ship with a custom pill, use the `-B` flag:
+
+```
+urbit -F zod -A /path/to/arvo -B /path/to.pill -c fakezod
+```
+
+To run all tests in `/tests`, run `+test` in dojo. `+test /some/path` would only run all tests in `/tests/some/path`.
+
+## Contributing
+
+Contributions of any form are more than welcome! If something doesn't seem right, and there is no issue about it yet, feel free to open one.
+
+If you're looking to make code contributions, a good place to start might be the [good contributor issues](https://github.com/urbit/arvo/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+contributor+issue%22).
+
+## Maintainers
+
+Most parts of Arvo have dedicated maintainers.
+
+* `/sys/hoon`: @pilfer-pandex (~pilfer-pandex)
+* `/sys/zuse`: @pilfer-pandex (~pilfer-pandex)
+* `/sys/arvo`: @jtobin (~nidsut-tomdun)
+* `/sys/vane/ames`: @belisarius222 (~rovnys-ricfer) & @joemfb (~master-morzod)
+* `/sys/vane/behn`: @belisarius222 (~rovnys-ricfer)
+* `/sys/vane/clay`: @philipcmonk (~wicdev-wisryt)
+* `/sys/vane/dill`: @bernardodelaplaz (~rigdyn-sondur)
+* `/sys/vane/eyre`: @eglaysher (~littel-ponnys)
+* `/sys/vane/ford`: @belisarius222 (~rovnys-ricfer) & @eglaysher (~littel-ponnys)
+* `/sys/vane/gall`: @jtobin (~nidsut-tomdun)
+* `/sys/vane/jael`: @fang- (~palfun-foslup) & @joemfb (~master-morzod)
+* `/app/acme`: @joemfb (~master-morzod)
+* `/app/dns`: @joemfb (~master-morzod)
+* `/app/hall`: @fang- (~palfun-foslup)
+* `/app/talk`: @fang- (~palfun-foslup)
+* `/lib/test`: @eglaysher (~littel-ponnys)
+
+## Contact
+
+We are using our new UI, Landscape, to run a few experimental cities. If you have an Azimuth point, please send us your planet name at [support@urbit.org](mailto:support@urbit.org) to request access.

mar/md.hoon

@@ -0,0 +1,19 @@
+::
+::::  /hoon/md/mar
+  ::
+/?    310
+::
+=,  format
+=,  mimes:html
+|_  txt/wain
+::
+++  grab                                                ::  convert from
+  |%
+  ++  mime  |=({p/mite:eyre q/octs:eyre} (to-wain q.q))
+  ++  noun  wain                                        ::  clam from %noun
+  --
+++  grow
+  |%
+  ++  mime  [/text/plain (as-octs (of-wain txt))]
+  --
+--