Re: Comments on hardware layout

[Shaun McCance <shaunm gnome org>]

On Thu, 2011-04-07 at 22:09 -0400, Shaun McCance wrote:
> Goals:
> * Make guides more compact and easier to scan. I want people
>   to spend as little time as possible on guide pages.
> * Trim down those links trails. Especially when we get guide
>   pages linked from guide sections of essentially the same
>   name: "Hardware > Printing >> Printing >>"
> 
> So I took a stab at using the grid ("toronto") layout on the
> hardware guide page. This is the same thing I did on prefs.
> It's not done. I'm not sure what to do with some pages.
> 
> Using the grid layout with links in descs gives us, I think,
> a nice way of promoting some subtopics without introducing
> extra link trails and guide links and navigational craziness.
> 
> Patch attached. This is only on a local branch on my machine,
> because I'm keeping master stable. I'd like feedback.

Updated patch attached

>From bf7fa000f3decbaca97beacd2ed3f22e16884a85 Mon Sep 17 00:00:00 2001
From: Shaun McCance <shaunm gnome org>
Date: Thu, 7 Apr 2011 22:04:09 -0400
Subject: [PATCH] hardware: First pass at grid layout on hardware

---
 gnome-help/C/printing.page |   10 +++-------
 gnome-help/Makefile.am     |    2 ++
 2 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/gnome-help/C/printing.page b/gnome-help/C/printing.page
index dc0d1f1..c41d9aa 100644
--- a/gnome-help/C/printing.page
+++ b/gnome-help/C/printing.page
@@ -3,9 +3,9 @@
       id="printing">
 
   <info>
-    <link type="guide" xref="hardware#printing" group="#first" />
+    <link type="guide" xref="hardware"/>
     
-    <desc>Learn about printing and using the more advanced features of your printer.</desc>
+    <desc>xxx</desc>
 
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
     <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
@@ -16,7 +16,7 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Printing</title>
+<title>Printers</title>
 
 <section id="setup" style="2column">
   <info>
@@ -33,10 +33,6 @@
 </section>
 
 <section id="problems" style="2column">
- <info>
-  <link type="guide" xref="hardware#problems"/>
-  <desc>Undetected printers, paper jams, print-outs that look wrong...</desc>
- </info>
  <title>Printer problems</title>
 </section>
 
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index 3f31bc0..15f1d6a 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -51,6 +51,7 @@ DOC_PAGES = \
 	backup-what.page \
 	backup-where.page \
 	backup-why.page \
+	bluetooth.page \
 	bluetooth-connect-device.page \
 	bluetooth-problem-connecting.page \
 	bluetooth-remove-connection.page \
@@ -60,6 +61,7 @@ DOC_PAGES = \
 	clock-calendar.page \
 	clock-set.page \
 	clock-timezone.page \
+	disk.page \
 	disk-benchmark.page \
 	disk-capacity.page \
 	disk-check.page \
-- 
1.7.3.2