Re: Overview bloat? (was [Fedora Project Wiki] Update of "Docs/Beats/Desktop" by RahulSundaram)
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