I think the idea of a "Developer Handbook" is a good one. That's separate from a "CouchDB Manual" though.
For now, let's focus on getting the manual up to scratch, and let's keep the handbook stuff on the wiki. We can re-evaluate the situation later. I'm not married to it. :) On 21 May 2013 16:00, Jan Lehnardt <j...@apache.org> wrote: > > On May 21, 2013, at 15:27 , Noah Slater <nsla...@apache.org> wrote: > > > Actually, I prefer that project documentation be kept on the wiki. > > > > The docs that we have in the source are the "CouchDB Manual" (as I > > have titled it), and I see them as a reference work for CouchDB itself. > > Setting it up, configuring it, using it, etc. > > > > I see the wiki as more a place for the project / community to document > and > > organise itself. Consider that our homepage is a single HTML page. Most > of > > what we'd usually have on a website was moved to the wiki. So, I'm > talking > > release process, release calendar, source locations, active releases, > > committer election process, PMC election process, and soon, by-laws, > > community guides, etc. > > > > I'd like to keep this stuff on the wiki for now. > > I want to start a section in there that is called “The Developer Handbook”. > The release docs would fit right in there, but this is your call > ultimately, > maybe we can have a pointer to the wiki from the docs/ then? > > Jan > -- > > > > > > > > > > On 21 May 2013 13:20, Jan Lehnardt <j...@apache.org> wrote: > > > >> On 21.05.2013, at 11:37, Dirkjan Ochtman <dirk...@ochtman.nl> wrote: > >> > >>> On Tue, May 21, 2013 at 11:33 AM, Jan Lehnardt <j...@apache.org> wrote: > >>>> It is all documented here: > >> http://wiki.apache.org/couchdb/Release_Procedure > >>> > >>> Oh, good. We should definitely pull stuff like that into a developer > >>> chapter of the docs, IMO. > >> > >> Go for it :) > >> > >> I think we have a rough consensus on moving most of the wiki into the > >> docs. Anyone, feel free to act on this! > >> > >> Jan > >> -- > >> > >> > > > > > > -- > > NS > > -- NS
