[kde-guidelines] Some simple updates to the HIG

[Andrew Lake]

Great, thanks so much for reviewing this Heiko and Thomas. So I made the
following changes based on your review:

- I moved the Patterns section from under VIewing and Navigation one level
up to the Behavior section. It now contains all the patterns in the HIG and
the relevant patterns are pointed from other sections to make sure they're
still easy to find regardless of use-vector.
- As Thomas mentioned the Organization covers the information architecture
(command structure and content structure) with links to the associated
command patterns and navigation patterns.
- Since there appeared to be no critical objections to the proposal, I went
ahead and moved the proposed changes to the HIG proper (
https://techbase.kde.org/Projects/Usability/HIG).
- At the bottom of the section and subsection pages, I added wiki controls
to go up a HIG level and to go the next or previous page in that section.
- I haven't yet moved the lowest level pages into their appropriate
sections yet (so that the wiki breadcrumb works properly and to add the
wiki controls from the previous bullet) but I'll try to get those done over
the next few days.

Totally agree on crowdsourcing the pics. A good bunch of them could be done
with the mockup toolkit.

Regarding the GNOME HIG, yeah no competition. They really did an excellent
job and honestly their work has been almost entirely motivational and
inspiring to me. ;-)

Hope this helps!
Andrew


On Sat, Sep 27, 2014 at 5:02 AM, Thomas Pfeiffer <colomar at autistici.org>
wrote:

> 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 ;) ).
> _______________________________________________
> kde-guidelines mailing list
> kde-guidelines at kde.org
> https://mail.kde.org/mailman/listinfo/kde-guidelines
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-guidelines/attachments/20140928/20a9fa20/attachment.html>