On 22 October 2011 23:12, Burkhard Lück <lu...@hube-lueck.de> wrote: > Hi Calligra devels, > > we'd like to export the kexi documentation on userbase to docbook and add it > to the calligra/doc folder for several reasons: > > * documentation is available without being online > * documentation is automatically processed by scripty and then picked up by > the translation teams -> many translated documentations (1.6.3 had 14 language > documentations) > * no change to your workflow, announce a release as usual on the > translators mailing list, several doc team members are subscribed there as > well, so the doc team will then update the svn docbook from the userbase page, > if necessary. > > This worls already quite well for the documentation of parley, k3b, amarok, > rekonq, kdevelop, kopete etc. > > Any comments?
Yuri already got my green light on Tuesday. And actually I am impressed the converter has been improved. Moreover "no change to our workflow" is great aspect! So yes, please add to calligra/doc/kexi (and then let's revert the kexi/kexi.desktop's X-DocPath field). I have one rather general question, do you think updates to the documentation have to be synchronized with Calligra/Kexi releases? Even if there's change and no release for an app, project members would want to extend documentation with bits they planned but just not made it for the release for whatever reason. I think both Calligra developers and members of the Documentation Team(s) could express their opinion on this one. I particularly would see liberal approach for documentation release schedules as nice but also can accept the rule when online documentation is ahead of the offline one. And I am assuming there is no concept of freezing periods for online documentation, but only expectation that it should be always made in "stable/clean" state each time the Doc Team grabs the content for offline releases. Would be great to note down see some such rules that we're collecting, as "official" - if there is anything missing. -- regards / pozdrawiam, Jaroslaw Staniek http://www.linkedin.com/in/jstaniek Kexi & Calligra (kexi-project.org, identi.ca/kexi, calligra-suite.org) KDE Software Development Platform on MS Windows (windows.kde.org) _______________________________________________ calligra-devel mailing list calligra-devel@kde.org https://mail.kde.org/mailman/listinfo/calligra-devel
