[weld-dev] ref guide (re)draft ready

[Pete Muir]

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.