Project

General

Profile

Documentation project » History » Revision 3

Revision 2 (Anonymous, 04/06/2013 01:27 PM) → Revision 3/42 (Anonymous, 04/06/2013 05:38 PM)

h1. Documentation 

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

 h2. Guides 

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

 * _User Guide_ - All of the information for anyone developing analysis or web applications using Orvos.  

 * _Administrator Guide_ - Instructions on how to administer and Orvos cluster for system administrators.  

 * _Installation Guide_ - How to install and configure Orvos to run in different cloud environments.  

 h2. Authoring Environment 

 All of the Orvos documentation is being written in Textile (the same language used for this wiki). Markdown. The files are stored and organized in a directory with in the Repository with sub-directories for each of the guides. As part of We are using XXX to generate the project there is a pipeline web help files and PDF files for generating each of the documentation based on Jekyll. guides. 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.