[wbs] response to 'TR Design Survey'

The following answers have been successfully submitted to 'TR Design Survey'
(public) for François Daoust.

> 
> ---------------------------------
> Group
> ----
> 
> On behalf of which W3C Working Group are you answering this survey?
> 
> 
> 
 
Second Screen Working Group

> 
> 
> ---------------------------------
> Sample(s)
> ----
> Paste in URLs to a representative sample (1-3 links) of your specs. If
> styling differs substantially between /TR and your editor's drafts,
> please link to both versions. 
> 
> 
 
http://w3c.github.io/presentation-api/

> 
> 
> ---------------------------------
> Specification Processor(s)
> ----
> What spec pre-processor(s) does your WG use?
> 
> 
 
ReSpec

> 
> 
> ---------------------------------
> Group style sheet(s)
> ----
> Paste in URLs to any WG-specific style sheets you use.
> 
> 
 
None, a few inline styles copied from HTML5 specs and that's about it.

> 
> 
> ---------------------------------
> Like
> ----
> What do you like about your current styles?
> 
> 
 
The overall simplicity

> 
> 
> ---------------------------------
> Dislike
> ----
> What do you dislike about your current styles?
> 
> 
 
- Lack of clean separation between sections
- On narrow screens, examples and interfaces styles overflow their
container. Not sure there is much that can be done there since these rows
do not wrap
- On narrow screens, the left banner takes a lot of space on the left. This
is particularly annoying when reading a spec on a mobile in portrait mode.
- In data tables, headers/borders are too strong/thick for our usage
(mapping between event handlers and event handler event type)
- Extensive use of terms and references creates lots of underlines in some
sections, particularly in algorithms.
- ReSpec includes a mechanism to display the list of terms defined in the
spec in a pop-up window. Could a similar mechanism be useful in the /TR
spec?
- Could there be a way to improve the layout of the terminology section
that references terms defined in other specs so that it feels more "human
friendly"?
- Algorithms are tough to read although that's arguably not a problem with
styles.
- Probably more platform-specific, but the result looks weird on Internet
Explorer for Mobile: text either appears as tiny (regular prose, examples)
or normal (ToC, algorithms, notes). Viewport directive?


> 
> 
> ---------------------------------
> Complex style
> ----
> Paste in URLs to any parts of your spec that are stylistically complex or
> tricky, and we should therefore be careful not to screw up.
> 
> 
 
Nothing too complex or specific to this spec. Example of procedure:
http://w3c.github.io/presentation-api/#starting-a-presentation-session



> 
> 
> ---------------------------------
> Table style
> ----
> The new styles will include rules for rendering data tables. These will
> be opt-in by class name, and rely heavily on good markup (use of THEAD,
> TBODY, COLGROUP, scope attributes, etc.). See Simple Example, Less Simple
> Example, and Extra-Complex Example. Paste in URLs to a sampling of any
> data tables you are using so that we can try to accommodate those in the
> styling, if practical. 
> 
> 
 
http://w3c.github.io/presentation-api/#event-handlers

> 
> 
> ---------------------------------
> CSS WG Style
> ----
> The CSSWG has made a number of minor improvements to the existing spec
> styles, which we might just adopt wholesale. Please comment on what you
> like/dislike about these styles, as demonstrated in the CSS3 Text
> specification.
> 
> 
 
- Good separation between sections
- Underlines seem to have been softened a bit, improving readability in
sections that use links a lot.
- It's very good to be able to quickly navigate to the fragment
corresponding to the underlying section or definition.
- Result looks good on Internet Explorer for Mobile with a couple of
exceptions: numbers in the ToC and left columns in data tables are tiny for
some reason (no viewport directive?)


> 
> 
> ---------------------------------
> Anything else?
> ----
> 
>     Is there anything else we should consider?
> 
> 
> 
 


> 
> These answers were last modified on 1 September 2015 at 07:37:56 U.T.C.
> by François Daoust
> 
Answers to this questionnaire can be set and changed at
https://www.w3.org/2002/09/wbs/1/tr-design-survey-2015/ until 2015-09-01.

 Regards,

 The Automatic WBS Mailer

Received on Tuesday, 1 September 2015 07:39:09 UTC