- From: Karen Coyle <kcoyle@kcoyle.net>
- Date: Fri, 26 Aug 2011 12:35:45 -0700
- To: public-lld@w3.org
Daniel, I think it helps to have the summaries as part of the list/table. I think we can reduce the tables in the html version -- possibly make them collapsable? Anyway, the tables in the wiki (which I'm impressed that you did so well!) aren't necessarily the same bulk as the tables in html. Could we experiment a bit with the html before you do more work moving them around? kc Quoting Daniel Vila <dvila@delicias.dia.fi.upm.es>: > Hi, > > Thanks for your comments and suggestions. > > I will definately reduce the number of columns including the link to either > the short summary or the wiki page directly I think is a good idea. > > However, I am not so sure about having the short descriptions under the > table as we will have again the problem identified by some reviewers and by > Antoine in yesterday's telco which is that it will take too long to get from > one cluster to another, thus difficulting reading through the report. > > My suggestion would be to keep the short summaries at the bottom of the > document as some kind of appendix for those interested to read a brief > introduction to individual use cases and have them referenced in each table, > adding backlinks in the short summaries to make easier get back to the > overview tables This would not imply to have the clusters mentioned twice > but only having two main sections: (1) description for each cluster > containing generalized and a table overview for each table, (2) a collection > of summaries of individual use cases. > > Do you think that structure makes sense? Otherwise I can move the short > summaries bellow the table as you suggested. > > Cheers, > > Daniel > > 2011/8/26 Jodi Schneider <jodi.schneider@deri.org> > >> The tables look great, Daniel! I do agree with Antoine that reducing the >> number of columns would be helpful. >> >> Rather than linking to the short summaries, I'd put those below each table. >> That way each cluster would be mentioned once in the document, which I think >> might be preferable. >> >> Then the use case name could be a link to the wiki--leaving just the title >> and short description as the two remaining columns in those tables. >> >> -Jodi >> >> >> On 26 Aug 2011, at 14:45, Antoine Isaac wrote: >> >> > 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_Casesand 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 >> > >> > >> >> > -- Karen Coyle kcoyle@kcoyle.net http://kcoyle.net ph: 1-510-540-7596 m: 1-510-435-8234 skype: kcoylenet
Received on Friday, 26 August 2011 19:36:15 UTC