On 30/11/09 6:29 PM, Andrus Adamchik wrote:
On Nov 30, 2009, at 3:39 AM, Aristedes Maniatis wrote:
When I'm done, I'd like to look at blowing away CAYDOC30 and making a
new copy since I'm hoping it will make more sense. This is one of the
reasons I don't like this forking of the docs so often, but I know I'm
in the minority on this one. When that's done I can remove the DI page
from CAYDOC30 which Andrus just added.
Thanks for the heads up. I also changed the Cayenne version in CAYDOC on
a few pages and added "What's new in 3.1" page. So maybe let's keep
CAYDOC30 unchanged. It is mostly frozen after all, so do we care to
clean it up at this point? What do you think?
Let's see how much I do after I find the time to work on the docs.
This is one of the reasons I don't like this forking of the docs so often
Ideally we'd use an SCM and branches to maintain multiple doc versions,
like we do for code. And we did that in the past. But that created a
significant barrier to editing the content. No ideal solution I guess :-/
Well, I'm about to embark on an experiment in docbook for my company. I've just
engaged a writer and we'll see in a few months how it all goes. We are doing
just that: taking docs out of our CMS and putting them into svn. Our goals are
to be able to generate pdf, embed docs into the application, etc.
In the meantime, let's keep going with what we have now.
Ari
--
-------------------------->
Aristedes Maniatis
GPG fingerprint CBFB 84B4 738D 4E87 5E5C 5EFA EF6A 7D2E 3E49 102A
