about Fundamental issues

[Marc Heyvaert]

Hi,

--- Carlos Leonhard Woelz <carloswoelz at imap-mail.com>
wrote:
> 
> This idea is good, but I don't think it is feasible.
> 
> The docs.kde.org already offer a view of the current
> KDE docs (CVS or 3.2
> branch). As someone who maintains identical wiki and
> cvs versions of
> documents, in a less complex format (html x
> docbook), I can tell you it
> would be a lot of work to maintain the wiki for all
> KDE docs.
> 

I am of the same opinion. The CVS solution offers an
ideal situation in the sense that there is a central
repository with version control and some control about
content (as not everyone can commit and commits can be
reversed if needed). It also guarantees the correct
docs for the correct versions of the software and via
the website you can always view the latest docs on
your browser. having some effort done on a wiki-type
repository would not offer the same advantages, hence
there should be synchronisation and this would lead to
inconsistencies and nightmare situations, even if a
conversion-script would exist.

Anyway. Editing docbook files with Quanta is really
easy (I've just started and with the template and some
existing docs it is really not difficult to do). New
docs may be somewhat complicated to set up, but people
who want to help could easily do this for existing
docs. They would only have to concern themselves with
very few tags, and I'm sure that if the patch they
submit is good, there will be people who would be
prepared to polish the first attempts of a new
volunteer and commit the patch.

just my 0.02

Regards

Marc




	
		
__________________________________
Do you Yahoo!?
Yahoo! Photos: High-quality 4x6 digital prints for 25¢
http://photos.yahoo.com/ph/print_splash