User Manuals: Difference between revisions

From OpenPetra Wiki
Jump to navigation Jump to search
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== User Manuals ==
== Overview ==
At this point in time, there is no proper documentation for users yet. You might want to have a look at the old [http://www.ict-software.org/petra/index.php?page=PetraUserGuides Petra 2.2 User Guides].
''At this point in time, there are no comprehensive User Guides for OpenPetra users available.''


The plan is to write the documentation here in the wiki, and then to automatically export it into PDF format and into Windows Help format, and possibly other formats as well.
===Current Options===
* A [[Basic Tutorial]] on OpenPetra is available. This is a guide to some of the basic functionality that is available in OpenPetra.
* A first start has been made at https://docs.openpetra.org/ and https://handbuch.openpetra.de/


TODO: instructions about how to organise chapters, topics, screenshots etc
==Goals of OpenPetra User Guides==
===Content===
* Should provide thorough instructions and answers on how to use OpenPetra effectively.


== Installation ==
===Portable===
Please see [[Installation Manuals]].
* User Guides should be viewable on any operating system. This goal could be reached by providing the User Guides in PDF format.


== General introduction ==


== Partner Module ==


== Finance Module ==
===Authoring of User Guides===
====Using Sphinx====
The plan is to write the content of the User Guides with Sphinx, store them in Github, and publish them at https://docs.openpetra.org/. Sphinx also allows to produce PDF files.


* [[HowTo: Initial setup of a ledger]]
See https://docs.openpetra.org/contributions/index.html for more details!


== Personnel Module ==
Sphinx projects can be published at https://readthedocs.org/
 
== Conference Module ==
 
== more TODO ==

Latest revision as of 06:29, 10 September 2022

Overview

At this point in time, there are no comprehensive User Guides for OpenPetra users available.

Current Options

Goals of OpenPetra User Guides

Content

  • Should provide thorough instructions and answers on how to use OpenPetra effectively.

Portable

  • User Guides should be viewable on any operating system. This goal could be reached by providing the User Guides in PDF format.


Authoring of User Guides

Using Sphinx

The plan is to write the content of the User Guides with Sphinx, store them in Github, and publish them at https://docs.openpetra.org/. Sphinx also allows to produce PDF files.

See https://docs.openpetra.org/contributions/index.html for more details!

Sphinx projects can be published at https://readthedocs.org/