On Friday, February 01, 2013 05:33:32 PM Jan Kundrát wrote: > On Tuesday, 29 January 2013 22:18:40 CEST, Randall Wood wrote: > > Team - here's a first draft of the docs (attached, hopefully > > the mailing list > > server sends along the attachment; otherwise I'll paste and resend).
> > Hi Randy, > thanks a lot for taking the time to write this and sorry for not responding > earlier. I hope I haven't managed to put you off yet. > Jan, no worries, I'm not easily put-off :) I've addressed all your concerns, clarifying things that needed clarifying, fixing the things I got wrong, and being a bit more specific in areas you thought needed better explanation. I forced the license to conform, as you requested. This might cause trouble: the Docs template seems to want the FDL license to be mandatory for all KDE documentation. I ignored that and manhandled it into GPL and CC, as requested. Let's see what happens. As for sending a render instead of XML, I'd like that too. I'm still finding my around the docs process (and team). I think it's a bit of a mess, with conflicting info, missing templates, and all the general bit-rot of inattention. I'm hoping to help them get *their* stuff in order too so the casual helper (like me, on Trojita) doesn't have to fumble around as much. I think they decided to change their system when they went from KDE3 to KDE4 and remnants of the old system are still around. Not surprisingly, there's lots of hacky stuff out there and even some people who seem to want to make their wiki the primary document source, and then auto-generate the help docs from the wiki (!!!). Question: where are the Trojita repositories located? If they're on KDE's servers now, I think all you have to do is commit a top-level folder called doc and put this .docbook file into it. From there, the autoscripts will find it, the translators will be alerted to its presence, and generally the rainbows and unicorns will fly out making the world a better place :) If they're however still at flaska.net I think for the moment this help doc won't get very far. Meanwhile, I'll stick around and try to make edits to the file now and again to keep it up with development, and generally be helpful if I can. R
trojita.docbook
Description: application/docbook
