Project

General

Profile

Documentation project » History » Version 5

Ward Vandewege, 04/08/2013 04:52 PM

1 1 Anonymous
h1. Documentation
2
3 5 Ward Vandewege
The documentation project is a part of the overall Arvados effort. 
4 1 Anonymous
5
h2. Guides
6
7 5 Ward Vandewege
There are three guides that will be developed to support the use of Arvados: 
8 1 Anonymous
9 5 Ward Vandewege
* [[User Guide]] - All of the information for anyone developing analysis or web applications using Arvados. 
10 1 Anonymous
11 5 Ward Vandewege
* [[Administration Guide]] - Instructions on how to administer and Arvados cluster for system administrators. 
12 1 Anonymous
13 5 Ward Vandewege
* [[Installation Guide]] - How to install and configure Arvados to run in different cloud environments. 
14 1 Anonymous
15
h2. Authoring Environment
16
17 5 Ward Vandewege
All of the Arvados documentation is being written in Textile (the same language used for this wiki). The files are stored and organized in a directory with in the Repository with sub-directories for each of the guides. As part of the project there is a pipeline for generating the documentation based on Jekyll. Bugs in the documentation can be submitted to as Issues. 
18 1 Anonymous
19
h2. Contributing Documentation 
20
21
To contribute to the documentation you should work with do documentation files in the same way that you would work with source code in GIT. (See more information about [[Contributing to the Project]].) At this stage we are not maintaining a separate documentation mailing list so we encourage people who want to contribute to the documentation to join the main developer mailing list.