On 2 Nov 2009, at 04:33, Dan Allen wrote:
I've made it all the way through the ref guide with revisions
that
reflect that changes to the RI and spec names and the latest
nomenclature and semantics from the spec. It's now ready for a
technical review and proofreading (in trunk)
Excellent!
https://svn.jboss.org/repos/weld/doc/trunk/reference
http://anonsvn.jboss.org/repos/weld/doc/trunk/reference
Since there was so much to change, I'm sure there are places where
the semantics didn't get properly updated or an explanation is still
out of date. Also, there were some areas of the ref guide that were
thin, and I didn't have time to fill it all in. If you feel
comfortable explaining a topic, please don't be shy to revise or
suggest revisions.
Here are some notes to consider:
- Java SE sections need review for accuracy, relevance
- Extending CDI (extend.xml) is extremely thin, to the point of
being marginally useful compared to the spec
This is what has changed the most since the guide was written I think.
I actually wonder if we should make two guides:
* Using CDI - the user guide
* Extending CDI - the guide for framework developers and integrators.
- Weld extensions (extensions.xml) is underwhelming; do we have more
to say than just about logging?
Not yet ;-)
- The chapter on producer fields (producerfields.xml) is missing,
though producer fields are explained in intro.xml
- The Weld SPI needs to be reviewed for accuracy, relevance (ri-
spi.xml); this was a *long* chapter and I just don't know the Weld
SPI yet
I will double check it, however it was up to date at the CR1 release.