[Live-demo] Application Quick Start - RST or docbook?

Cameron Shorter cameron.shorter at gmail.com
Thu Jul 1 15:14:53 EDT 2010


christopher.schmidt at nokia.com wrote:
> On Jun 30, 2010, at 8:42 AM, ext Cameron Shorter wrote:
>
>   
>> Project champions,
>>
>> I notice that a number of projects have been using sphynx/RST wiki format to store their documentation.
>>
>> Would people prefer to use docbook or RST as the source format for creating the "Application Overview" and "Quickstart" documentation for each project?
>>
>> Attached is a template for the quickstart in Open Office format, and also the Project Overview.
>>
>> If there is a desire to use RST as the documentation format, I'd be keen to have some advice on how to build the RST template docs, and styling for the output.
>> Even better would be if someone has templates already which we can make use of
>>     
>
> I'd highly recommend RST. 
>
> Are these single-files, or sets of files? In general, the way to build 
> things out of rst for collections of files is actually sphinx, and the 
> way to build single files is:
>   
Chris, we will be creating ProjectOverviews and QuickStarts for each 
project. Ie, 2 docs for each project, which will be converted into 2 
HTML pages for each project.
The output will look something like the project descriptions linked 
from: http://live.osgeo.org/content.html
The structure of the docs is defined here: 
http://wiki.osgeo.org/wiki/Marketing_Artefacts#Application_Overview

In future releases of OSGeo Live, we will likely also be creating full 
training workbooks, which will likely be multiple pages.

-- 
Cameron Shorter
Geospatial Solutions Manager
Tel: +61 (0)2 8570 5050
Mob: +61 (0)419 142 254

Think Globally, Fix Locally
Geospatial Solutions enhanced with Open Standards and Open Source
http://www.lisasoft.com



More information about the Live-demo mailing list