Project

General

Profile

Actions

Documentation project » History » Revision 27

« Previous | Revision 27/42 (diff) | Next »
Tom Clegg, 03/04/2014 01:45 PM


Documentation

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

Guides

There are four guides that are being developed to support the use of Arvados:

  • User Guide - Introductory and tutorial materials for building analysis or web applications using Arvados.
  • API Reference - REST API methods and resources, the MapReduce job execution environment, permission model, etc.
  • Admin Guide - Instructions to system administrators for maintaining an Arvados installation.
  • Install Guide - How to install and configure Arvados on the cloud management platform of your choice.

A web version of the documentation is available at http://doc.arvados.org.

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.

Contributing

Bugs in the documentation can be submitted as 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.

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:

Contributor quick-start:

git clone git://github.com/curoverse/arvados.git
cd arvados/doc
bundle install
rake
# documentation will be generated in .site/

To generate Python SDK docs, install epydoc and arvados-python-client before running rake in arvados/doc:

sudo apt-get install python-pip python-virtualenv
virtualenv /tmp/z
PATH=/tmp/z/bin:$PATH
pip install epydoc arvados-python-client
rake

Updated by Tom Clegg over 10 years ago · 27 revisions