Re: New draft of Mobile Web Applications Best Practices (rev 11) uploaded.

Thanks Adam!

Please find a couple of comments not related to the actual content below.

Adam Connors wrote:
>     * There are a couple of TODOs which will need to be removed before
>       FPWD. If you can provide feedback on these as part of the call
>       this Thursday I  will produce an updated draft with them removed
>       which is (in principle at least) ready for FPWD.

Note "editorial notes" are a good thing for FPWD, as it helps tell 
readers the readers areas that we know deserve some more consideration.


>     * The index needs to be updated and the links to the BPs -- is there
>       an automated way to do this ?

Yes and no.
I suppose there are as many ways as there are editors around the place.

For the summary list of Best Practices, the main problem, I guess, is 
not the generation of the summary itself, but rather the lack of 
"Statements" within the document. Section 2 explains that Best Practices 
are composed of a heading, some statements, and further subsections. We 
only have the headings so far. It's easy to generate the summary of 
headings, but that's no different from the Tables of Content, and is 
thus a bit useless. I suggest we drop this section for the time being, 
and put an editorial note in Section 2 to say that the "Statements" will 
come in a future revision of the doc.

For the index, I'd say the easiest way would be to use some XSLT magic. 
But that supposes that the document is a valid XML document (which it's 
not, since it's in HTML 4.01).

I created a small XSLT stylesheet that:
  1/ makes sure that all headings get an id
  2/ removes the existing TOC
  3/ creates the Table of Contents (and its Appendices part) from the 
main headings of the document.

The XSLT may only be applied to a tidied version of the document.

Using HTML Tidy and the Online XSLT services, this yields the following 
result:
http://www.w3.org/2005/08/online_xslt/xslt?xslfile=http%3A%2F%2Fwww.w3.org%2F2005%2FMWI%2FBPWG%2FGroup%2FDrafts%2FBestPractices-2.0%2Fmwabp-inserttoc.xsl&xmlfile=http%3A%2F%2Fcgi.w3.org%2Fcgi-bin%2Ftidy%3FdocAddr%3Dhttp%253A%252F%252Fwww.w3.org%252F2005%252FMWI%252FBPWG%252FGroup%252FDrafts%252FBestPractices-2.0%252FED-mobile-bp2-20080707.html&content-type=&submit=transform

The XSLT itself is available at:
http://www.w3.org/2005/MWI/BPWG/Group/Drafts/BestPractices-2.0/mwabp-inserttoc.xsl

Received on Tuesday, 8 July 2008 11:25:33 UTC