I really don't care what the format we use is, just the following: 1. information is easy to find 2. information follows a sensible order (related things feel related, you aren't pushed to read something you don't need, you are pushed to read the things you do need to know first) 3. it is easy to contribute to 4. contributions are easy to review before inclusion 5. contributions are encouraged 6. contributors do not require the skills of a magazine editor (eg the documentation leader(s) could put out a request for info on a feature and a potential contributor like myself can give the raw facts without worrying about trying to make it easy to grok or concern that it will be ignored [btw, I am a bad example here because I'd probably fit more in at the editorial side than the fact giving side]).
Am I missing anything? hammett wrote: > Some background for what's worth: > > - In the previous wiki style things were just too disconnected. Works > fine for wikipedia but not for something that might need to have a > reading order > - There was an attempt to keep each article on the new format very > short. This is pure usability. If people see a long scroll they feel > it's gonna take too much time to read and leave. This is especially > true for the getting started sections > - The format and organization was inspired by apache httpd documentation > - Keeping documentation for older versions was also inspired by the > apache httpd documentation and a book suggested this approach as well. > I think the book was "Producing Open Source Software" > - I sincerely dislike the docbook style, but I'm willing to give it a > try. Never really liked the way NHibernate and Spring are documented. > - The anakia style is also an attempt to keep formatting/layout > separated from the docs. I think that was successful, but it does make > contribution more difficult. > > > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Castle Project Development List" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/castle-project-devel?hl=en -~----------~----~----~----~------~----~------~--~---
