On 3/17/11 11:13 AM, Werner F. Bruhin wrote:
> On 17/03/2011 18:22, Paul McNett wrote:
>> On 3/17/11 9:41 AM, Werner F. Bruhin wrote:
>>> On 17/03/2011 17:30, Paul McNett wrote:
>>>> Werner,
>>>>
>>>> I didn't want you to think I've been ignoring the conversion to Sphinx, 
>>>> I've just
>>>> been very busy. I will try to find time soon to get the proper environment 
>>>> set up on
>>>> my server and try generating the docs!
>>> No problem.
>>>
>>> The following is still active:
>>> http://thewinecellarbook.com/daboDocTestAlt/
>>>
>>> I am updating it once in a while when I come across issues/problems, or
>>> after having done some new stuff (like the summary tables for the
>>> property/methods.
>>>
>>> I'll remove it whenever you got it up on your server.
>> How about I link to it from the old dabodoc page for now?
> A link is fine with me, but I would leave the old doc still there so in
> case issues come up one can refer back to the old doc.

I think this would be a good transition:

1) Link to "new docs" for a time (6 weeks?), saying "please report any issues 
you find"

1a) Start generating new docs nightly

2) Default to the new docs, keeping a link to the old alive. Keep this for 
probably 6 
months.

3) Warn that old api docs going away and to speak up if you are reliant on them 
(because we want to know why). 6 weeks

4) Stop generating old docs

So we'll start step 1 by linking to the docs on your server. I'll set that up 
right now.

Paul

_______________________________________________
Post Messages to: [email protected]
Subscription Maintenance: http://leafe.com/mailman/listinfo/dabo-dev
Searchable Archives: http://leafe.com/archives/search/dabo-dev
This message: http://leafe.com/archives/byMID/[email protected]

Reply via email to