Opened 15 years ago

Closed 14 years ago

#430 closed task (fixed)

Create documentation for the LiveDVD

Reported by: camerons Owned by: live-demo@…
Priority: normal Milestone:
Component: OSGeoLive Keywords: documentation
Cc:

Description

User level documentation needs to be added for each application.

I'm looking for direction as to what this documentation should look like, and how it should be written.

At the moment, I think it should be available via a HTML page.

To start with, I've copied the documentation from the 2008 Live DVD into https://svn.osgeo.org/osgeo/livedvd/gisvm/trunk/doc/ arramagong.css banner.bmp index.html jquery.js

Docs are updated using https://svn.osgeo.org/osgeo/livedvd/gisvm/trunk/bin/install_main_docs.sh

Change history (5)

comment:1 by jsanz, 15 years ago

On the sample scripts (I remember udig at least) every project downloads its documentation to the recommended folder (/usr/share/_project_), so I assume this should be replaced by moving the docs download to this new script.

comment:2 by camerons, 15 years ago

The release VERSION number should be included in the documentation. It is stored in: https://svn.osgeo.org/osgeo/livedvd/gisvm/trunk/VERSION.txt

Changes should be referenced from the LiveDVD docs, and possibly should be copied onto the DVD too. https://svn.osgeo.org/osgeo/livedvd/gisvm/trunk/CHANGES.txt

We should have an "About Arramagong GISVM" item from the pull down menu, which references the version number. (In the same way as there is an "About Xubuntu")

in reply to:  2 comment:3 by hamish, 15 years ago

Replying to camerons:

Changes should be referenced from the LiveDVD docs, and possibly should be copied onto the DVD too.

setup.sh installs a package called subversion-tools. This includes a little program called svn2cl. You point svn2cl at your Subversion repository (ie .../gisvm/trunk/) and it creates a ChangeLog file detailing each checkin. yay automation.

https://svn.osgeo.org/osgeo/livedvd/gisvm/trunk/CHANGES.txt

(d.n.e.)

Hamish

comment:4 by hamish, 14 years ago

Keywords: documentation added

fyi Markus found this link, looks interesting:

http://johnmacfarlane.net/pandoc/ http://johnmacfarlane.net/pandoc/demos.html ... http://trac.osgeo.org/grass/ticket/151#comment:11


and since it isn't listed in this ticket yet here's the nice Mediawiki -> PDF converter: http://en.wikipedia.org/wiki/Help:Books

Hamish

comment:5 by hamish, 14 years ago

Resolution: fixed
Status: newclosed
Note: See TracTickets for help on using tickets.