Hi Michal, Yes they were moved around an hour ago. I was just doing a preliminary check before mailing the dev list. Anyway, as Michal says, please can everyone check your seciton of the docs, ideally by COB on Monday. Please email me with the sections you have checked, and then I will chase up any unchecked sections! Thanks On 23 Jun 2011, at 14:44, Michal Linhard wrote:

Status * Wiki articles moved back to wiki :-) * Docs sorted into - User Guide - Developing the Infinispan Framework Guide - Tutorials - FAQs There is extensive work to do to get this all consistent etc. I will continue to work on it - but it will take me time. I will add a style guide to the development guide for everyone to follow, asap. On 24 Jun 2011, at 16:14, Pete Muir wrote:

Hi Sanne I also feel that it already feels more like documentation - funny how just the feel of a tool changes it. I think we have a long way to go though, to make it as good as e.g. the Hibernate docs, or Weld docs. Things I have identified: * make the layout and formatting consistent. There are many different header levels in use, different styles applied for defining terminology etc. I will write up a style guide for this next week, and also work through the existing docs and apply * make the writing style, language and grammar consistent - at the moment the doc does feel like it's been written by 5 or 6 people, when it should feel like it's been written by one * add more to the tutorials (and rename these to a Getting Started Guide), and add in more quickstart examples (this is something we are trying to improve JBoss wide, and I will probably be updating/adding the the main guidelines for JBoss) * add more in the way of recommendations and "patterns" to the main user guide (and make this more of a reference guide) - I think with BigData this is especially important * Organize the FAQs (we have a lot, possibly too many, some need moving into the user guide I expect) * Integrate the "New in version XXX" into the main user guide, and add a "Since version XXX" to that page as needed (it's dreadful to make a user look in 5 places to understand what to do!) Open questions I would like feedback on (there will be more!): * Media (e.g. videos, podcasts). Currently these are collected on both the wiki and in the docs. I would like to collect them all on the wiki, but link to them from the docs as relevant. Do others agree? On my TODO: * Sort out how we do includes (I played with various approaches yesterday, I prefer to keep each chapter as one page, or multiple pages, and include onto the main page) * Consistent style * Update Wiki homepage to incude all examples On 24 Jun 2011, at 22:51, Sanne Grinovero wrote: It's working fine for me (in Chrome). Have you tried the wiki markup tab? We can't just remove "Framework". Experience has taught (from Hibernate and Seam/Weld) that if you have a page/guide "Development of Infinispan" that most people will assume it is a guide about developing apps using Infinispan, not a guide about how to develop Infinispan itself. We found the best answer is to add something like Framework or Library to the title, as this clears up the ambiguity. If Infinispan is not a framework, what is it? (That's a real question, not rhetorical ;-).