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. |