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

[Dan Allen]

Some minor formatting updates that should make certain sentences easier to
read (dashes were messed up).

-Dan

On Sun, Nov 1, 2009 at 11:48 PM, Dan Allen <dan.j.allen at gmail.com> wrote:

> 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 at gmail.com> 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 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
>> >
>> > _______________________________________________
>> > weld-dev mailing list
>> > weld-dev at lists.jboss.org
>> > https://lists.jboss.org/mailman/listinfo/weld-dev
>> >
>>
>>
>>
>> --
>> Gavin King
>> gavin.king at 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
>



-- 
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/16de6dfa/attachment-0001.html 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: weld-refguide-20091101b.pdf
Type: application/pdf
Size: 769566 bytes
Desc: not available
Url : http://lists.jboss.org/pipermail/weld-dev/attachments/20091102/16de6dfa/attachment-0001.pdf