[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-doc-english
Subject:    Re: [kde-doc-english] KDE User Guide outdated?
From:       Arturo Silva <jasilva28 () gmail ! com>
Date:       2009-09-27 18:10:03
Message-ID: 955730e10909271110q54af4184v28fc80941d1087fe () mail ! gmail ! com
[Download RAW message or body]

On Sun, Sep 27, 2009 at 6:18 AM, Burkhard L=FCck <lueck@hube-lueck.de> wrot=
e:
>
> * index.docbook is broken, does not pass checkXML index.docbook here :-(
>
> * please don't change the folder layout (png's in a subfolder of visualdi=
ct,
> this breaks the current cmake macro kde4_create_handbook and makes your u=
pdate
> unusable for the english documentation as for all language documentations=
 as
> well.
>
> * please send only the changed files (or even just a svn diff). In your z=
ip
> archive with a mixture of files from kdelibs and from kdebase/runtime and=
 even
> from your distro I can not recognize which files from the svn archiv are
> changed and therefore check, if and how your update can be integrated int=
o the
> kde system.
>


Hmm, that is kind of overestimating the extent of my contribution or
what little knowledge I managed to scrape up over the course of the
week regarding this format.  I don't even understand half of what
you're saying (diff?), and I really explained before this is not taken
from the SVN copy nor really meant to be committed back to SVN in its
current form.  All I really need is for it to be reviewed, and then
whoever is knowledgeable enough (and also happens to have an SVN
account) can take the best of my draft copies and apply it to the
trunk copies in a way that doesn't break anything.

If for whatever reason you can't read what I sent you (and welcome to
my world if you can't), then try using the attached HTML copies if you
want.

From what Anne has stated, it sounds like there does seem to be a
consensus that a more human-editable documentation format is at least
sought after -- and while the current format has its merits (it seems
easy to translate), its low level of customization and presentation
seems to put it at odds with the rest of the KDE4 desktop.

So I get the feeling I'm out of my element and will only get in the
way if I continue, so regretfully I will have to pull out of this User
Manual project after all.  While I'll gladly continue to help review
draft documentation if necessary, I want to focus on my projects in
kde-games and kde-artwork where I can make more immediate and less
intrusive contributions that are also better suited to my current
skill set and schedule.

Sorry this didn't work out.  :(
But hey, at least you have 23 less screenshots to worry about, so it
wasn't a total loss.  ;)

Take care.


--Arturo

["html.zip" (application/zip)]

_______________________________________________
kde-doc-english mailing list
kde-doc-english@kde.org
https://mail.kde.org/mailman/listinfo/kde-doc-english


[prev in list] [next in list] [prev in thread] [next in thread]