Finish the old HIG [was Re: [kde-guidelines] This & That]

Lauri Watts lauri at kde.org
Tue Dec 7 23:05:00 CET 2004


On Tuesday 07 December 2004 22:46, Frans Englich wrote:
> On Sunday 05 December 2004 01:55, Frans Englich wrote:
>
> <snip>
>
> >1) it
> > has the TOC/organization which Ellen suggested; 2) It is spell
> > checked/edited for sanity/spec quality; and has various boring grunt work
> > done, such as 3) 400 table entries; and 4) inline elements.[4]

> Yep, that's the description of the Docbook/edited version at:
>  http://usability.kde.org/hig/current/
>
> The problem is that we have two HIGs in CVS, while we only link to the one
> at:
> http://developer.kde.org/documentation/standards/kde/style/basics/index.htm
>
> This gives me the creep, because users mail me about "the" HIG, and I have
> no responsibility for the latter. We must remove one of them, I think.

I was actually under the impression the former was to be removed.  It has 
quite some objections.  The one on developer.k.o is to all intents and 
purposes "The" HIG currently.

> To me, I think the Docbook'd version is superior(see above). Also, since
> we'll use it as base for our future HIG, it's pretty good to has as our
> old. However, I wasn't involved in re-adding the hig at developer.kde.org
> and redirecting the links, so someone else will have to speak up.

It's only superior right now in that it's got prettier graphics.  The markup 
is incomplete and incorrect.  If it's going to be retained, at least it 
should be a fixed up version.  You can stop ranting to me about the 400 table 
entries, because I have since corrected several hundred *more* that were 
flagrantly wrong, along with a fair amount of other dodgy markup, and that 
was just on one run through.  I don't doubt I'd find more to fix if I went 
over it again.  I don't see any reason to commit that to a version without 
mandate and with objectors.  It's available for anyone who wants it copying 
relevant passages.

Regards,
-- 
Lauri Watts
KDE Documentation: http://docs.kde.org
KDE on FreeBSD: http://freebsd.kde.org
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://mail.kde.org/pipermail/kde-guidelines/attachments/20041207/601317a8/attachment.pgp


More information about the kde-guidelines mailing list