[Build-common-hackers] Documenting CDBS

[Jonas Smedegaard]

On Thu, Mar 24, 2011 at 07:26:03PM -0400, Felipe Sateler wrote:
>On Thu, Mar 24, 2011 at 19:53, Marc Dequènes (Duck) <duck at duckcorp.org> 
>wrote:
>> Coin,
>>
>>> Quoting Felipe Sateler <fsateler at debian.org>:
>>>
>>>> Well, yes and no. I do want to have better CDBS docs, and am 
>>>> willing to take the challenge, but I don't really have much time. I 
>>>> would hate to stand in the way of others (I started going through 
>>>> the docs but I barely made it throught the first couple of 
>>>> paragraphs). And if someone can do this faster than me, then it 
>>>> would be great!
>>
>> Did anything happen on this front?
>>
>> My documentation is now a few versions late, so even if it is mostly 
>> bugfix releases, a few updates are certainly needed. A few other 
>> things are missing or need to be improved too. Even if DH7+ is 
>> stealing most of our userbase, i think it's not yet time to stop the 
>> maintenance. I'll probably work on this in a not so far future, but i 
>> wont have time to change the format. If someone is already working on 
>> the fusion/format change, i may just contribute to this version 
>> instead of mine. So, if anyone's working on this, please let me know.
>
>I haven't done anything. I haven't had much time for debian, and will 
>probably continue that way in the immediate future.

I also have not yet looked at it.

If I recall correctly, only Felipe and I had considered to work on the 
documentation (Felipe on merg the two sources, and I on converting to 
Markdown).  So if you want to try merge, Marc, it should be safe to do 
that now, without risk of clashing with related efforts.

I agree that CDBS is not dead, and our users therefore will benefit from 
an improved documentation.  I have no plans to abandon CDBS!

If you (like me) suspect that your merging efforts will be easier to do 
_after_ converting to Markdown, then tell me, and I shall try harder to 
take some time to look into that conversion (for both the mainline docs 
and yours, and also for translations of yours!).


   - Jonas

-- 
   * Jonas Smedegaard - idealist & Internet-arkitekt
   * Tlf.: +45 40843136  Website: http://dr.jones.dk/

   [x] quote me freely  [ ] ask before reusing  [ ] keep private
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/build-common-hackers/attachments/20110325/76b91743/attachment.pgp>