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
This archive was generated by hypermail 2.0.0 : Mon Nov 30 2009 - 02:54:51 EST