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

Great idea Gavin ;) I should have picked up on your cue of attaching drafts to e-mails. -Dan p.s. Keep the following in mind, which I wrote in the "notes" section before the first chapter: Note that this reference guide was started while changes were still being made to the specification. We've done our best to update it for accuracy. If you discover a conflict between what is written in this guide and the specification, the specification is the authority--assume it is correct. If you believe you have found an error in the specification, please report it to the JSR-299 EG. On Sun, Nov 1, 2009 at 11:40 PM, Gavin King <gavin.king(a)gmail.com&gt; wrote: > Dan, that's really great! > > Could you mail us a PDF, so I can read it on the plane tomorrow? Thanks! > > On Sun, Nov 1, 2009 at 11:33 PM, Dan Allen <dan.j.allen(a)gmail.com&gt; 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 > > > > _______________________________________________ > > weld-dev mailing list > > weld-dev(a)lists.jboss.org > > https://lists.jboss.org/mailman/listinfo/weld-dev > > > > > > -- > Gavin King > gavin.king(a)gmail.com > http://in.relation.to/Bloggers/Gavin > http://hibernate.org > http://seamframework.org > -- 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