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

[Dan Allen]

Once Weld RC2 is released (should be soon), please pay particular attention
to the "getting started" chapter (chapter 3) to make sure it covers every
last step to deploy the two starter examples. We don't want any errors here
because this is our 10 minute test opportunity!

-Dan

On Sun, Nov 1, 2009 at 11:33 PM, Dan Allen <dan.j.allen at gmail.com> 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)
>
> 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
> - Weld extensions (extensions.xml) is underwhelming; do we have more to say
> than just about logging?
> - 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 did add a lot of content while revising, but the ref guide can always be
> improved.
>
> -Dan
>
> --
> Dan Allen
> Senior Software Engineer, Red Hat | Author of Seam in Action
> Registered Linux User #231597
>
> http://mojavelinux.com
> http://mojavelinux.com/seaminaction
> http://www.google.com/profiles/dan.j.allen
>



-- 
Dan Allen
Senior Software Engineer, Red Hat | Author of Seam in Action
Registered Linux User #231597

http://mojavelinux.com
http://mojavelinux.com/seaminaction
http://www.google.com/profiles/dan.j.allen
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/weld-dev/attachments/20091102/cab2e30a/attachment.html