Hmm, the task-oriented approach could be a good idea. We could have the user perspective
at the beginning and an under-the-cover look at what's going on at the end. If we can
find a good set of tasks that cover everything we want to talk about, we could probably
merge all the different guides together and save us some trouble down the road by avoiding
duplicate content.
However, this would probably be a major undertaking. As it is, I'd already merge the
quickstart and user guides using this approach since there is a lot of overlap. Moreover,
the user guide is not that interesting as it is since it doesn't really go much above
where to click... So the approach of showing how to do something then explaining what we
just did could be a good one.
View the original post :
http://www.jboss.com/index.html?module=bb&op=viewtopic&p=4060117#...
Reply to the post :
http://www.jboss.com/index.html?module=bb&op=posting&mode=reply&a...