Congratulations to the whole team on the improving quality of the documentation!
If users haven't been here yet...
http://docs.jboss.org/tools/3.0.0.CR1/
...they are missing some great stuff. The JSF tools material was particularly helpful to me. It has increasing amounts of "why" commentary in addition to the description of features. Please keep expanding the "why" content.
Along with the screencasts and tutorials, this is really going to help with getting this stuff adopted. (Along with Katz's book of course) 8-)
Regards.
Glad you liked it.
If you got specific links for things you liked and areas that could need some work please let us know.
3.0.0.CR1 contains *alot* related to JSF :)