Apache OpenOffice (AOO) Bugzilla – Issue 71884
Free developers guide
Last modified: 2013-02-24 21:09:47 UTC
Issue to track evolution of the freeing steps for developpers guide previously discussed on api and documentation mailing lists seems bounded to legal implications
accepted The work on open sourcing the DevGuide is ongoing. Besides the open source question we also think about a new format and also about a wiki solution. Currently the used format is flat xml (OpenOffice XML not OpenDocument)
set target
hmm. wiki would be bad. requires online acess. or do you want to create a pdf? How do you do that then? How do you keep the pdf up-to-date with every change done in the wiki? I think a xml/latex/whatever-based thing built during the build (or at least being able to build it by sopme makefile target/script which can be done offline) is best.
We are about to start a pilot that will use wiki as the collaboration platform. Wikis are much more suited for easy contributions than offline formats. Having the wiki published into some other format is an issue that we also need to cover. Jürgen, I should start to write up a pilot proposal for that. I would like to place that in the documentation project, can we link to api.oo.o? Everyone is invited to comment on the proposal once it's out there.
Frank, starting the proposal is a good idea and of course you can link to the api project and the currently available DevGuide.
thanks a lot for taking care even if IZ is not for commenting and discussing, here are my views - wiki may be a convenient way to collaborate, not for the final document - the one elaborated should be able to handle section translations in other language (JP, ZN, FR, IT, that mediawiki does not handle natively i think) and defaulting in a choosen language. - the same for alternative code snippets really, this things may be discussed on mailing lists Please give also update on the legal issue
set target 3.0
fixed -> a DevGuide is now online available in the wiki http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/OpenOffice.org_Developers_Guide Before anybody starts with loalization please wait on the official go or better the guidelines how to do it. I expect this info soon. The strucure of the guide requires some guidelines to keep the whole document well formed in general and for future post processing.
closed
@jsc: you rock :)