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

Hi Daniel,

Sorry for the late answer...
The deliverable looks indeed much better like this!

I'm wondering whether we need all 4 columns, though. The items in the first column could be hyperlinks to the short summaries, and the links to the separate wikipages could appear as notes in the 2nd column. Or something like that...

But well, maybe that's a matter of taste. I just wanted to make the suggestion; if there were comments from reviewers for having URLs more visible. I won't argue...

Cheers,

Antoine


> 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 Friday, 26 August 2011 13:44:10 UTC