[kde-guidelines] Some simple updates to the HIG

[Thomas Pfeiffer]

On Saturday 27 September 2014 08:52:31 Heiko Tietze wrote:
> On Friday 26 September 2014, 16:37:17 Andrew Lake wrote:
> > Let me know if it's ok to "ship it!". :-)
> 
> The landing page is pretty nice, easy to scan, and I agree with renaming and
> collapsing of the Structure section. The disadvantage is that it adds
> another click. Which is acceptable, IMHO. And we could think about having a
> breadcrumb on top.

I agree with Heiko: Awesome work on the landing page, Andrew!
The added click is totally fine I think, because we've seen in the test at 
Akademy that currently users spend much more time trying to find their way 
through the huge page than they would need for that further click.

+1 for the bradcrumb, and we actually get that for free if we put all HIGs 
that belong to a section below that section in the "file system hierarchy" 
(that would need quite some work moving pages, but I think it's worth it for 
the sake of organization).
That way (since all the section pages actually have content in them) techbase 
automatically adds the section to the bradcrumb that is automatically created 
at the top of the pages

> But I'd change the section on patterns. Right now it's found below
> Navigation which sounds reasonable for the navigational and content pattern
> itself, but that's actually only due to the name. We should move both
> sections to a more prominent position, like Getting Started > Information
> Architecture. And patterns in terms of the combination of controls are some
> kind of solution to complex problems, for instance search and replace. So
> why not place it at Getting Started > Best Practice?

The command and navigation patterns are in Getting Started -> Organization by 
now, which makes sense to me.

About the "combination of controls for a certain problem" kind of patterns I 
agree that they should be in a different section. I don't think they should be 
under "Getting Started" because I suppose one would be looking for them at a 
later point (that assumption should be tested, of course!).
I'd put them under Behavior.

> Nevertheless, great work, Andrew! And for sure our HIG is more than
> competitive with Gnome :-).

I haven't put enough time into reading the GNOME HIG to compare the two, but 
especially if we get more visual examples integrated (maybe we should try to 
crowdsource that, too?), I think we're in a pretty good position (and there is 
no need to compete with the GNOME HIG, anyway ;) ).