[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Overview bloat? (was [Fedora Project Wiki] Update of "Docs/Beats/Desktop" by RahulSundaram)

> The following page has been changed by RahulSundaram:
> http://fedoraproject.org/wiki/Docs/Beats/Desktop
> + 
> + 
> + = Comment =
> + 
> + Since the overview section covers the destkop already, do we need this section for FC6?
> + 

Good question.  My thoughts are like this ...

1. What does a user/reader do when coming to a massive release notes
like this, with a comprehensive Tables of Contents?
  a. Look through the ToC for relevant items and go read them?
  b. Read the introduction/overview, and consider going deeper?

Our current setup actually supports both, except that from the OverView,
the reader is not directed to the relevant content areas.  Instead, they
get a comprehensive overview right there.

Perhaps the OverView should say something brief, then link to more

We faced this with FC5, where the OverView grew to be so big that it was
repeating information stated elsewhere, which means it now had to be
maintained twice.

The OverView is starting to remind me of the old Fedora/RHEL release
notes.  One, long page with all the information in brief.  

Is it useful to have both styles supported?

- Karsten
Karsten Wade, RHCE, 108 Editor    ^     Fedora Documentation Project 
 Sr. Developer Relations Mgr.     |  fedoraproject.org/wiki/DocsProject
   quaid.108.redhat.com           |          gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

Attachment: signature.asc
Description: This is a digitally signed message part

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]