Arvados

h1. Documentation

The documentation project is a part of the overall Arvados effort. 

h2. Guides

There are three guides that will be developed to support the use of Arvados: 

* "User Guide":http://doc.arvados.org/user/ - All of the information for anyone developing analysis or web applications using Arvados. 

* "Administration Guide":http://doc.arvados.org/admin/ - Instructions on how to administer and Arvados cluster for system administrators. 

* "Installation Guide":http://doc.arvados.org/install/ - How to install and configure Arvados to run in different cloud environments. 

h2. Documentation Project

The Arvados documentation is written in Markdown, Textile, and HTML. The source code is in the @doc@ directory in the Arvados source tree. We use Jekyll to render HTML pages.

h2. Contributing

Bugs in the documentation can be submitted as "issues":/projects/arvados/issues.

To contribute to the documentation, clone the Arvados source repository, edit, and send pull requests just as you would when contributing program source code (see [[Contributing to the Project]]).

We do not yet maintain a separate documentation mailing list, so we encourage documentation contributors to join the main developer mailing list.

References for contributors:

* "Markdown syntax":http://daringfireball.net/projects/markdown/syntax

* "Textile syntax":http://en.wikipedia.org/wiki/Textile_(markup_language)

* "Jekyll usage":https://github.com/mojombo/jekyll/wiki/Usage (Note: Jekyll 0.12.1 auto-refresh "bug":https://github.com/mojombo/jekyll/issues/882 and "workaround":http://stackoverflow.com/questions/15591000/jekylls-auto-doesnt-work for devs.)

* "Liquid for designers":https://github.com/shopify/liquid/wiki/liquid-for-designers (template engine)

Contributor quick-start:

<pre>

git clone git://github.com/clinicalfuture.com/arvados.git

cd arvados/doc

jekyll --server --auto

# point browser to http://localhost:4000/doc/

vi api/index.md

</pre>