I don't think there is a right answer here as it mainly comes down to personal preference. How we each like to see information presented. If I were travelling in my car I'd prefer to read a line on a map, many people I know would much prefer to read a list of written instructions (turn right here, turn left there etc.) and forgo the map. Same information, different presentation. I guess we just need to try and cover the most bases without making too much work for ourselves.
I made a couple of examples of the Reference type information I would like to see. This is just intended to provide an index into exisiting information in the site. User Reference: http://cwiki.apache.org/confluence/display/TUSCANY/SCA+Java+User+Reference Developer Reference: http://cwiki.apache.org/confluence/display/TUSCANY/SCA+Java+Developer+Reference I'm not convinced everything here is either in the right category or is well described but you get the idea. Many projects at Apache provide a reference approach to accessing information as well as providing a guide/tutorial approach, for example, HTTPD, ActiveMQ, Ant, Maven etc. Simon
