KDE Development book: organizational questions

[Ralf Nolden]

On Samstag, 19. Juli 2003 10:36, Benjamin Meyer wrote:
> > as there already was a *LOT* of response on this (more than I expected),
> > I'd like to propose we create a new mailinglist for the book
> > writers/translators/readers. Then we should discuss where to put the book
> > (CVS wise): kdeextragear-2 or developer.kde.org ? with developer.kde.org
> > are ACL's an issue or not ? Can the HTML docs be auto-generated by the
> > developer.kde.org server so we can save generating the HTML files and
> > keeping them in CVS ?
> >
> > If anyone has some technical clue about that, please share :-)
>
> Things like documentation generation should always be automated and never
> done manually.  The cvs libs documentation is moving in that direction and
> this should also. (With snapshots for 1.0 etc of course :)  The only thing
> that should be in CVS is the docbooks one would think.

Yes, that's what I meant. We should have a build system to generate HTML 
output - for the end-user/writer just grabbing the CVS - and one automated, 
cron-job scheduled generation on developer.kde.org that would auto-generate 
the HTML pages for the server daily. Is that possible ?

BTW we discussed on IRC how we could also re-use feedback. I propose we manage 
the auto-generation to generate buttons on each section that brings the 
reader to a Linux Wiki page. There he can add comments (of course only for 
registered users so we don't get unwanted input) which can be automatically 
send to the kde-devel-book@ (or to kde-devel-book-authors@ if we want that 
too) mailinglist for further processing by the authors, e.g. read the 
comment, reformulate the according section of the docs or update/correct the 
information in the docs. That way we'd have direct feedback like bugfixes 
that non-developers can contribute to the book easily.


Ralf

Ralf

>
> -Benjamin Meyer

-- 
We're not a company, we just produce better code at less costs.
--------------------------------------------------------------------
Ralf Nolden
nolden at kde.org

The K Desktop Environment       The KDevelop Project
http://www.kde.org              http://www.kdevelop.org
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: signature
URL: <http://mail.kde.org/pipermail/kde-core-devel/attachments/20030719/e0caef99/attachment.sig>