XBL2 Primer - call for public input

Hi All, 

As we have mentioned previously, we are working on the XBL2 Primer in
the hope that (when XBL2 gets implemented) it will make XBL easier for
developers to pick up. We are currently looking for public input on what
the XBL Primer should cover, including: 

 

The focus of the document: currently we are focusing exclusively on how
to use XBL in a web development scenario (ie. just html and xhtml).
However, it might be nice to cover other things, like simple computer
games.

 

Tone of the document:  unlike the XBL spec, the document is being
written in a relaxed style using an active voice. (ie. "In this section
we will look at X and you will be introduced to Y").

 

Real-world scenarios: are there any particular use cases you would like
to see covered? We are currently looking at using some of the Ajax
design patterns [1] in an XBL context.  

 

Structure of the document: what would be the most useful way to
structure the document for developers? We are currently considering
breaking the document into four parts. Firstly, a gentle introduction to
XBL that discusses what XBL is, how to bind, how to use shadow content
templates, how to use an implementation, how to extend a binding, and
event handling). 

 

Secondly, we want to explain the content of the XBL spec including every
aspect of the language in such a way that it serves as a quick look-up
reference. We want each section to include at least one or more real
world usage scenarios and for each section to be summarised 'at a
glance'. We also want each section to link to appropriate sections in
the XBL spec, where the reader can find the normative descriptions. 

 

Thirdly, we want to provide a section on XBL and accessibility that
covers how XBL can be used to enhance the accessibility of existing web
documents. For this section, we are currently considering making an
accessible Stock-Portfolio widget that provides multiple representations
of the same information (svg pie chart, html table, and spoken). 

 

Fourthly, we also want to provide a "cheat sheet" that shows for each
element what it does, what the possible attributes are, any default
values, and possibly the content model, and link to examples. 

 

The initial working draft of XBL Primer will be available at the URL
below. Please note that the current version is out of date, I will post
the latest version in next week and send out and email to this list... 

 

http://dev.w3.org/cvsweb/~checkout~/2006/waf/XBLPrimer/Overview.html

 

Kind regards, 

Marcos 

 

[1] http://ajaxpatterns.org/Main_Page