Project

General

Profile

Documentation project » History » Revision 5

Revision 4 (Tom Clegg, 04/08/2013 12:03 PM) → Revision 5/42 (Ward Vandewege, 04/08/2013 04:52 PM)

h1. Documentation 

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

 h2. Guides 

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

 * [[User Guide]] - All of the information for anyone developing analysis or web applications using Arvados. Orvos.  

 * [[Administration Guide]] - Instructions on how to administer and Arvados Orvos cluster for system administrators.  

 * [[Installation Guide]] - How to install and configure Arvados Orvos to run in different cloud environments.  

 h2. Authoring Environment 

 All of the Arvados Orvos 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.  

 h2. Contributing Documentation  

 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.