[Use case side-deliverable] Alternative organization to improve readability

Hi all,

The deliverable is almost finished, after addressing the several comments
and reviews.

There has been a general comment by at least two reviewers (Jodi Schneider
and András Micsik) about the sections organization and the difficulty to
read the individual summaries.

To mitigate this I propose an alternative organization based on the
following:

- Provide a section for each cluster containing:

     - Generalized cases
     - A table with an overview of the individual use cases with the
following columns: (1) name, (2) short (one sentece) description, (3) link
to complete summary and (4) link to wiki page.

- Provide a section detailing the individual summaries (as in previous
version) with a back-link to the overview table of previous section.

An example of the proposed structure can be found in:
http://www.w3.org/2005/Incubator/lld/wiki/UseCaseReport#Bibliographic_data(Please
note that this is the cluster with the highest number of use cases
so other tables will look shorter).

Of course the new structure should be explained in the intro section and the
headings changed accordingly.

Another option is to remove completely the short summaries in
http://www.w3.org/2005/Incubator/lld/wiki/UseCaseReport#Summary_of_individual_Use_Cases
and
remove (3) link to complete summary column, but i think that way we loose
helpfull introductory information.

I would like to gather everyone's opinion on this and know if you think that
this helps.

In any case, I plan to finalize the deliverable tomorrow.

Cheers,

Daniel

Received on Thursday, 25 August 2011 13:55:51 UTC