[wbs] response to 'TR Design Survey'

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

> 
> ---------------------------------
> Group
> ----
> 
> On behalf of which W3C Working Group are you answering this survey?
> 
> 
> 
 
XML Query 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. 
> 
> 
 
https://www.w3.org/TR/xquery-31/
https://www.w3.org/TR/xpath-functions-31/

> 
> 
> ---------------------------------
> Specification Processor(s)
> ----
> What spec pre-processor(s) does your WG use?
> 
> 
 
If I understand your question correctly, the only pre-processor we use is
tidy. 

> 
> 
> ---------------------------------
> Group style sheet(s)
> ----
> Paste in URLs to any WG-specific style sheets you use.
> 
> 
 
http://www.w3.org/StyleSheets/TR/W3C-WD.css
http://www.w3.org/StyleSheets/TR/W3C-CR.css
http://www.w3.org/StyleSheets/TR/W3C-PR.css
http://www.w3.org/StyleSheets/TR/W3C-WG-NOTE.css

> 
> 
> ---------------------------------
> Like
> ----
> What do you like about your current styles?
> 
> 
 
They are conformant with PubRules, and our user community is experienced
with and comfortable with them. 

> 
> 
> ---------------------------------
> Dislike
> ----
> What do you dislike about your current styles?
> 
> 
 
Not anything, really. 

> 
> 
> ---------------------------------
> 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.
> 
> 
 
https://www.w3.org/XML/Group/qtspecs/specifications/xquery-31/html/xquery-31-diff.html

Diff markup using our styles can be tricky (especially when we have marked
up diffs within diffs, such as a change to an inserted section or a
deletion of part of a changed section). We think we've tamed the diff
markup, but every now and again we discover some edge case that doesn't
work quite right. 

https://www.w3.org/XML/Group/qtspecs/specifications/xquery-31/html/xquery-31-diff.html#id-sequencetype-syntax

Our language grammar is defined using a very specific and customized XML
vocabulary and generating HTML that displays the grammar (extended BNF) is
very tricky, especially when generating multiple HTML documents from single
sources. 

> 
> 
> ---------------------------------
> 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. 
> 
> 
 
https://www.w3.org/XML/Group/qtspecs/specifications/xquery-31/html/xquery-31-diff.html#id-sequencetype-syntax

Our documents display our language grammar using HTML tables, which leads
to some interesting styling requirements. 

https://www.w3.org/XML/Group/qtspecs/specifications/xquery-31/html/xquery-31-diff.html#id-sequencetype-subtype

This section of one of our documents contains a fairly simple table, but it
is more complex than most of the tables we use. 

> 
> 
> ---------------------------------
> 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.
> 
> 
 
No opinion one way or the other. 

> 
> 
> ---------------------------------
> Anything else?
> ----
> 
>     Is there anything else we should consider?
> 
> 
> 
 
The XML Query WG MAY be nearing the end of its life, which would obviate
the need, and likelihood, of it learning to use new styles.  In any case,
whether or not the WG closes, what we have ain't broke and we see no need
to "fix" it. 

> 
> These answers were last modified on 28 May 2015 at 00:10:41 U.T.C.
> by Jim Melton
> 
Answers to this questionnaire can be set and changed at
https://www.w3.org/2002/09/wbs/1/tr-design-survey-2015/ until 2015-07-07.

 Regards,

 The Automatic WBS Mailer

Received on Thursday, 28 May 2015 00:12:03 UTC