In other words you want the best of both worlds. So far I havent found such thing..
Might consider giving this drupal a try... On Fri, Oct 31, 2008 at 11:24 AM, Bill Barry <[EMAIL PROTECTED]> wrote: > > 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. >> >> >> > > > > > -- Cheers, hammett http://hammett.castleproject.org/ --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
