Is documentation single sourcing really the holy grail?

2008-05-18 Thread Chase
I believe there is a problem with the current guidelines and infrastructure for maintaining the Struts 2 documentation. This is an attempt to help everyone see the barriers and problems with the way it's setup now. Hopefully the process can be improved. If you haven't already please read http

Re: Is documentation single sourcing really the holy grail?

2008-05-18 Thread Musachy Barroso
I have always thought (and said a couple of times), that we should have different doc sets depending on the versions. I usually work on trunk, and I know every time I add something new to the docs(because of a new feature in trunk) it will end up confusing users of the last stable build. We use the

Re: Is documentation single sourcing really the holy grail?

2008-05-18 Thread Chase
Musachy Barroso wrote: About the snippets, they are handy for commiters because they can update the code and forget about the wiki, but yes, it prevents users with just a CLA to fix problems. For these quick spelling/minor comment changes you can ping me in IRC and I could fix them right away.