[wbs] response to 'TR Design Survey'

The following answers have been successfully submitted to 'TR Design Survey'
(public) for David Carlisle.

> 
> ---------------------------------
> Group
> ----
> 
> On behalf of which W3C Working Group are you answering this survey?
> 
> 
> 
 
Math WG 

> 
> 
> ---------------------------------
> 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. 
> 
> 
 

**MathML3
TR
http://www.w3.org/TR/MathML3/

Editors draft
http://www.w3.org/Math/draft-spec/mathml.html

Note MathML3 is published in several forms (html4, pdf, html5/mathml etc)
the editors draft version has several style changes that have been
requested by readers since the TR publication, most notably a maximum
width of the text body and permalinks on all section headings which appear
on mouseover currently.


** XML entities
TR
http://www.w3.org/TR/xml-entity-names/

Editors draft
http://www.w3.org/2003/entities/2007doc/




> 
> 
> ---------------------------------
> Specification Processor(s)
> ----
> What spec pre-processor(s) does your WG use?
> 
> 
 
XSLT using a modified version of xmlspec sources. (The Math WG has been
using a forked version of xmlspec since before XSLT 1 was a
recommendation.) 

> 
> 
> ---------------------------------
> Group style sheet(s)
> ----
> Paste in URLs to any WG-specific style sheets you use.
> 
> 
 
The generated HTML just uses standard rec track css stylesheets augmented
by inline style block in the document head.


> 
> 
> ---------------------------------
> Like
> ----
> What do you like about your current styles?
> 
> 
 
Suitable for document production pipeline from multiple sources, including
rendering mathematical examples from tex fragments in the source,
generating tables of data extracted from Unicode UCD files etc.

Presentation in multiple formats but notably with MathML and optional
mathjax rendering, tables of contents at different levels for main document
and chapters. permalinks and constrained page width in editors draft. 

> 
> 
> ---------------------------------
> Dislike
> ----
> What do you dislike about your current styles?
> 
> 
 
Tables of contents are internally a mess, should be redone as nested lists
not paragraphs with forced space. (Present form was a compromise to work in
IE5/Netscape 4....)

I (David C) dislike the unconstrained width of the page in the TR styles.


> 
> 
> ---------------------------------
> 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.
> 
> 
 

Any math examples eg

http://www.w3.org/Math/draft-spec/mathml.html#chapter3_id.3.2.5.8.1

any attribute table eg

http://www.w3.org/Math/draft-spec/mathml.html#chapter3_id.3.3.2.2

hyperlinked RelaxNG grammars eg

http://www.w3.org/Math/draft-spec/mathml.html#appendixa_parsing.rnc.strict


> 
> 
> ---------------------------------
> 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. 
> 
> 
 
Attribute tables as noted before

http://www.w3.org/Math/draft-spec/mathml.html#chapter3_id.3.3.2.2

The operator dictionary

http://www.w3.org/Math/draft-spec/mathml.html#appendixc_oper-dict.entries-table

is a very large table (thousand or so lines) and uses sortable
columns.(Currently using http://www.kryogenix.org/code/browser/sorttable/
but if a standard solution to sortable tables was offered it would be OK to
switch.)


In entities spec:

Tables of math alphabets
http://www.w3.org/TR/xml-entity-names/bold.html

Tables of unicode ranges
http://www.w3.org/2003/entities/2007doc/026.html

As all the html markup is generated, changing the html markup and/or css
classes here is not a problem as we can generate whatever is required for
the new style. Assuming the new style is just applied to new documents. An
earlier attempt at restyling was retrospectively
applied to existing documents in TR (and broke them completely) 

> 
> 
> ---------------------------------
> 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.
> 
> 
 
Generally in favour of the direction taken there as long as there is some
flexibility, mathml has a lot of examples and tables for example that may
necessitate a slightly wider body width, we'll see...


> 
> 
> ---------------------------------
> Anything else?
> ----
> 
>     Is there anything else we should consider?
> 
> 
> 
 
Math rendering... 

> 
> These answers were last modified on 31 July 2015 at 13:00:40 U.T.C.
> by David Carlisle
> 
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 Friday, 31 July 2015 13:03:05 UTC