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

[Rahul]

Karsten Wade wrote:
>> 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
> content?
> 
> 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?
> 

As the beat writer for the section, I chose the current style to give 
our users a very quick glance at major changes rather than make them 
scroll through different sections to get an idea of the improvements. It 
could be possible that there are desktop changes that arent major and 
require some brief coverage in other sections but if a section is empty 
as it is right now, we can drop it before the final release IMO.

Rahul