CouchDB documentation

[till <ti...@php.net>]

On Mon, Jul 4, 2011 at 5:50 PM, Robert Newson <ro...@gmail.com> wrote:
> All good questions -- for a different thread

Ok, done.

:-)

So anyone have any ideas or preferences?

Here are some questions:

Where will documentation 'live'?
Will a CLA be required to contribute to it?
Format?
Anything ongoing?

Till

Re: CouchDB documentation

[till <ti...@php.net>]

Cool, that sounds all good to me. Has anyone started on this yet?

Also, can you guys recommend any tools to edit docbook [Mac, Linux,
Windows]? ;-)

I don't care if they are commercial or 'free'.

I've used docbook for pear/php but I've always used a text editor and
editing etc. is pretty tedious since it comes with a learning wall.

Till

On Mon, Jul 4, 2011 at 7:42 PM, Paul Davis <pa...@gmail.com> wrote:
> On Mon, Jul 4, 2011 at 1:37 PM, Robert Newson <ro...@gmail.com> wrote:
>> From the existing thread (which I can't find either!), we had several
>> votes for DocBook, the source of those docs to live alongside the code
>> in the same svn repository we all know and love (or keep at arms
>> length with git-svn). I'm sure we'd need signoff for contributed docs
>> like we do for code.
>
> No more signoff than the current JIRA. Not to be confused with CLA.
> Though its generally recommended that significant contributors have a
> CLA on file. So, enh.
>
> Also, yeah. docbook in the repo. Generated output to live at
> http://couchdb.apache.org/lookatmyfancydocs
>
>>
>> B.
>>
>> On 4 July 2011 17:56, till <ti...@php.net> wrote:
>>> On Mon, Jul 4, 2011 at 5:50 PM, Robert Newson <ro...@gmail.com> wrote:
>>>> All good questions -- for a different thread
>>>
>>> Ok, done.
>>>
>>> :-)
>>>
>>> So anyone have any ideas or preferences?
>>>
>>> Here are some questions:
>>>
>>> Where will documentation 'live'?
>>> Will a CLA be required to contribute to it?
>>> Format?
>>> Anything ongoing?
>>>
>>> Till
>>>
>>
>

Re: CouchDB documentation

[Paul Davis <pa...@gmail.com>]

On Mon, Jul 4, 2011 at 1:37 PM, Robert Newson <ro...@gmail.com> wrote:
> From the existing thread (which I can't find either!), we had several
> votes for DocBook, the source of those docs to live alongside the code
> in the same svn repository we all know and love (or keep at arms
> length with git-svn). I'm sure we'd need signoff for contributed docs
> like we do for code.

No more signoff than the current JIRA. Not to be confused with CLA.
Though its generally recommended that significant contributors have a
CLA on file. So, enh.

Also, yeah. docbook in the repo. Generated output to live at
http://couchdb.apache.org/lookatmyfancydocs

>
> B.
>
> On 4 July 2011 17:56, till <ti...@php.net> wrote:
>> On Mon, Jul 4, 2011 at 5:50 PM, Robert Newson <ro...@gmail.com> wrote:
>>> All good questions -- for a different thread
>>
>> Ok, done.
>>
>> :-)
>>
>> So anyone have any ideas or preferences?
>>
>> Here are some questions:
>>
>> Where will documentation 'live'?
>> Will a CLA be required to contribute to it?
>> Format?
>> Anything ongoing?
>>
>> Till
>>
>

Re: CouchDB documentation

[Robert Newson <ro...@gmail.com>]

>From the existing thread (which I can't find either!), we had several
votes for DocBook, the source of those docs to live alongside the code
in the same svn repository we all know and love (or keep at arms
length with git-svn). I'm sure we'd need signoff for contributed docs
like we do for code.

B.

On 4 July 2011 17:56, till <ti...@php.net> wrote:
> On Mon, Jul 4, 2011 at 5:50 PM, Robert Newson <ro...@gmail.com> wrote:
>> All good questions -- for a different thread
>
> Ok, done.
>
> :-)
>
> So anyone have any ideas or preferences?
>
> Here are some questions:
>
> Where will documentation 'live'?
> Will a CLA be required to contribute to it?
> Format?
> Anything ongoing?
>
> Till
>

Re: CouchDB documentation

[Noah Slater <ns...@apache.org>]

On 4 Jul 2011, at 17:56, till wrote:

> On Mon, Jul 4, 2011 at 5:50 PM, Robert Newson <ro...@gmail.com> wrote:
>> All good questions -- for a different thread
> 
> Ok, done.

Please review the previous, and recent, thread on this:

http://mail-archives.apache.org/mod_mbox/couchdb-dev/201106.mbox/%3C02E53EA0-4601-437F-9B18-72A74803D712@apache.org%3E

Or search your mail for:

Re: [Couchdb Wiki] Trivial Update of "CouchDB_in_the_wild" by wentforgold

Probably answers most of your questions.