View Issue Details

IDProjectCategoryView StatusLast Update
0001463ardourdocumentationpublic2017-05-17 08:18
Reportertimbyr Assigned Totimbyr  
PriorityhighSeveritymajorReproducibilityN/A
Status closedResolutionfixed 
Summary0001463: Documentation required on how to contribute to the ardour manual
DescriptionThe Ardour manual has been converted to DocBook and some documentation should be available on how to contribute. This documentation should cover at least:

- What dependencies are required to convert the DocBook source into various formats(only XHTML at this stage) and how to do it.

- The basics of the DocBook format or links to existing documentation.

- Any specific usage of DocBook tags such as using recursive <section> tags vs <sect1-5> etc.

- Add a help target to the build system(A Makefile for now)
TagsNo tags attached.

Activities

timbyr

2007-02-05 01:55

developer   ~0003169

Perhaps this information should be placed in the appendix of the manual in a Contributing section.

timbyr

2007-02-05 03:53

developer   ~0003172

It should also include guidelines for screenshots and diagrams, for instance:

Screenshots:
- file format
- platform
- window decoration theme/etc
- size
- subpixel aa/filtering

Diagrams:
- file format
- size
- palette
- fonts

timbyr

2007-02-08 05:03

developer   ~0003194

Last edited: 2007-02-08 10:51

References to style guidelines that closely match the manual style that we(I'm not sure who 'we' is at this point) would like to adhere to.

some possible ideas/candidates:

Gnome Documentation Style Guide (http://developer.gnome.org/projects/gdp/styleguide.html) which is 404 at the moment.

The Style chapter of the Fedora Documentation Guide.

http://fedora.redhat.com/docs/documentation-guide/

Others...?

Headwar

2017-05-17 08:18

reporter   ~0019718

https://github.com/Ardour/manual

Issue History

Date Modified Username Field Change
2007-02-04 06:28 timbyr New Issue
2007-02-05 00:06 timbyr Status new => assigned
2007-02-05 00:06 timbyr Assigned To => timbyr
2007-02-05 01:55 timbyr Note Added: 0003169
2007-02-05 03:53 timbyr Note Added: 0003172
2007-02-08 05:03 timbyr Note Added: 0003194
2007-02-08 05:04 timbyr Priority normal => high
2007-02-08 10:51 timbyr Note Edited: 0003194
2017-05-17 08:18 Headwar Note Added: 0019718
2017-05-17 08:18 Headwar Status assigned => closed
2017-05-17 08:18 Headwar Resolution open => fixed