[Dev] where to put developer docs?

Mike Taylor bear at code-bear.com
Tue Nov 29 13:14:56 PST 2005


Hmm, that means I jumped the gun when I modified the documentation  
generation script to put the Chandler 0.6 branch docs into  
chandler.osaf.org then :)


On Nov 29, 2005, at 4:10 PM, Katie Capps Parlante wrote:

> I don't think developer docs need to be placed in the  
> chandler.osafoundation.org web; www.osafoundation.org/current/docs is  
> just fine. They'll be linked to from the wiki and from a 'developer  
> start' page in chandler.osafoundation.org.
>
> I don't have strong opinions about this, other than I do think it  
> would be valuable to have dev docs in the distribution. Of course,  
> this would mean that we need dev docs to be updated in both the trunk  
> and the branch, and that we can't change them after the documentation  
> complete milestone (2 weeks after code freeze).
>
> This of course doesn't apply to 0.6 specs. In particular I think this  
> is appropriate for the tutorial related docs and the architecture  
> overview.
>
> Cheers,
> Katie
>
> Mike Taylor wrote:
>> If those are being updated then will they need to be placed into the   
>> new chandler.osafoundation.org web?  Currently only the trunk   
>> chandler/distrib/docs are updated and those are sent to the   
>> www.osafoundation.org/current/docs directories.
>> On Nov 29, 2005, at 2:26 PM, Katie Capps Parlante wrote:
>>> I was assuming we'd put them in chandler/distrib/docs, where we have  
>>>  other html specs, and where they will be included with the   
>>> distribution.
>>>
>>> Cheers,
>>> Katie
>>>
>>> Mike Taylor wrote:
>>>
>>>> If they will be html that will be in the Chandler web tree then for  
>>>>  now put them in docs/trunk/sites/chandler/
>>>> On Nov 29, 2005, at 2:11 PM, Alec Flett wrote:
>>>>     I'm giving morgen a hand with the ZaoBao tutorial, and I'd like  
>>>> to
>>>>     do it in HTML, rather than the Wiki.. do we have a place in SVN  
>>>> to
>>>>     store developer docs? I pulled docs/trunk/docs but I'm just  
>>>> seeing
>>>>     specs there...
>>>>     Alec
>>>>     _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
>>>>     Open Source Applications Foundation "Dev" mailing list
>>>>     http://lists.osafoundation.org/mailman/listinfo/dev
>>>> ---
>>>> Bear
>>>> Build and Release Engineer
>>>> Open Source Applications Foundation (OSAF)
>>>> bear at osafoundation.org
>>>> http://www.osafoundation.org
>>>> bear at code-bear.com
>>>> http://code-bear.com
>>>> PGP Fingerprint = 9996 719F 973D B11B E111 D770 9331 E822 40B3 CD29
>>>> -------------------------------------------------------------------- 
>>>> -- --
>>>> _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
>>>> Open Source Applications Foundation "Dev" mailing list
>>>> http://lists.osafoundation.org/mailman/listinfo/dev
>>>
>>>
>>>
>> ---
>> Bear
>> Build and Release Engineer
>> Open Source Applications Foundation (OSAF)
>> bear at osafoundation.org
>> http://www.osafoundation.org
>> bear at code-bear.com
>> http://code-bear.com
>> PGP Fingerprint = 9996 719F 973D B11B E111  D770 9331 E822 40B3 CD29
>> ---------------------------------------------------------------------- 
>> --
>> _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
>> Open Source Applications Foundation "Dev" mailing list
>> http://lists.osafoundation.org/mailman/listinfo/dev
>
>
---
Bear

Build and Release Engineer
Open Source Applications Foundation (OSAF)
bear at osafoundation.org
http://www.osafoundation.org

bear at code-bear.com
http://code-bear.com

PGP Fingerprint = 9996 719F 973D B11B E111  D770 9331 E822 40B3 CD29


-------------- next part --------------
A non-text attachment was scrubbed...
Name: PGP.sig
Type: application/pgp-signature
Size: 186 bytes
Desc: This is a digitally signed message part
Url : http://lists.osafoundation.org/pipermail/dev/attachments/20051129/2433b871/PGP.pgp


More information about the Dev mailing list