Sean, The manual is looking great so far. Such high quality documentation is such a rare thing in the open source world that I think we should all be very appreciative. Comparing this (and the excellent actually-explains-the-underlying-framework-code tutorials and Javadoc) with the Repast Simphony ones is like comparing night and day IMO (though they perhaps have slightly different target audiences and, to be fair to Repast, it is labelled as beta at the moment). Having used MASON quite a bit, I thought the existing documentation was good (esp. the level of detail in the Javadocs), so this is just the icing on the cake. With that sycophancy aside :-), a couple of points/questions: i) Are the existing tutorials still to be retained and subject to the same level of attention as the manual? I hope so (despite the tutorial in the manual), and think they're nicely complementary. I presume all the example models will stay as well (with any tweaks required to match the new codebase). ii) Would you consider a short Introduction sub-section on the support and previous/ongoing funding of MASON? It's always useful as a user to have a feel for such aspects. I appreciate (as an academic) that academic funding is precarious at the best of times, but I don't know, for example, what types of agreements you have with GMU. If some/all of this is a little sensitive/political, then fair enough not to include it. iii) Just some typos I spotted whilst whizzing through (with section numbers): 1.3: This example caused --> This example causes 11: high-level than, say, OpenGL --> higher-level than, say, OpenGL Stuart