You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@couchdb.apache.org by Benoit Chesneau <bc...@gmail.com> on 2008/07/01 10:54:39 UTC
wiki proposal
Hi all,
While doing translation of the wiki in french, it come to my mind that
the wiki could be better organized.
For now, we have some proposals mixed with the reference doc, Install
doc is after the reference where it should be first imho, before
"started" pages. On the other hand, future of couchdb, proposals,
hacks and projects around couchdb are mixed everywhere in the doc.
What I thought is a structure of the wiki like this :
1) Install CouchDB
2) Start with with CouchDB
3) Reference/ CouchDB API (and only reference)
4) Couchdb
- About
- FAQ
- Future
- Proposals
5) Around CouchDB :
- In the wild
- Projects
- Hacks/ Forks
Something like it. What do you think about it ? Any other suggestions ?
- benoît
Re: wiki proposal
Posted by Benoit Chesneau <bc...@gmail.com>.
On Wed, Jul 2, 2008 at 1:02 PM, Noah Slater <ns...@apache.org> wrote:
> On Wed, Jul 02, 2008 at 12:20:29AM +0200, Benoit Chesneau wrote:
>> Hum , I don't know if basics and ecosystem are right words for this.
>> This isn't basics since for now it's only docs on how use couchdb with
>> your language. Ecosystem, maybe that's me, but this word sound cold,
>> it gives an impression of distance from the community.
>
> I was just trying to kepp them single words for aesthetic reasons.
> Either way, just have at it. We can edit later if we need to. :)
>
ok so will start changes tomorrow. too much work for today :/
- benoît
Re: wiki proposal
Posted by Noah Slater <ns...@apache.org>.
On Wed, Jul 02, 2008 at 12:20:29AM +0200, Benoit Chesneau wrote:
> Hum , I don't know if basics and ecosystem are right words for this.
> This isn't basics since for now it's only docs on how use couchdb with
> your language. Ecosystem, maybe that's me, but this word sound cold,
> it gives an impression of distance from the community.
I was just trying to kepp them single words for aesthetic reasons.
Either way, just have at it. We can edit later if we need to. :)
--
Noah Slater, http://people.apache.org/~nslater/
Re: wiki proposal
Posted by Benoit Chesneau <bc...@gmail.com>.
On Tue, Jul 1, 2008 at 2:14 PM, Noah Slater <ns...@apache.org> wrote:
> On Tue, Jul 01, 2008 at 10:54:39AM +0200, Benoit Chesneau wrote:
>> 1) Install CouchDB
>> 2) Start with with CouchDB
>> 3) Reference/ CouchDB API (and only reference)
>> 4) Couchdb
>> - About
>> - FAQ
>> - Future
>> - Proposals
>> 5) Around CouchDB :
>> - In the wild
>> - Projects
>> - Hacks/ Forks
>
> Thinking about it, I would change the wording so it was:
>
> 1) Installation
> 2) Basics
> 3) Reference
> 5) Ecosystem
> 6) Development
>
Hum , I don't know if basics and ecosystem are right words for this.
This isn't basics since for now it's only docs on how use couchdb with
your language. Ecosystem, maybe that's me, but this word sound cold,
it gives an impression of distance from the community.
Oh I would distinct presentation of couchdb and faq from Reference.
Maybe that's what you see in basics ?
> Also, I presume you're only talking about the organisation of the front page?
yes
> I wouldn't like to see actual pages be renamed or given 2 levels or anything.
Well it need some cleanup in content and some moves. But still only 1
level obviously.
- benoît
Re: wiki proposal
Posted by Noah Slater <ns...@apache.org>.
On Tue, Jul 01, 2008 at 10:54:39AM +0200, Benoit Chesneau wrote:
> 1) Install CouchDB
> 2) Start with with CouchDB
> 3) Reference/ CouchDB API (and only reference)
> 4) Couchdb
> - About
> - FAQ
> - Future
> - Proposals
> 5) Around CouchDB :
> - In the wild
> - Projects
> - Hacks/ Forks
Thinking about it, I would change the wording so it was:
1) Installation
2) Basics
3) Reference
5) Ecosystem
6) Development
Also, I presume you're only talking about the organisation of the front page?
I wouldn't like to see actual pages be renamed or given 2 levels or anything.
Best,
--
Noah Slater, http://people.apache.org/~nslater/
Re: wiki proposal
Posted by Damien Katz <da...@gmail.com>.
On Jul 1, 2008, at 9:01 AM, Robin Berjon wrote:
> On Jul 1, 2008, at 11:05 , Jan Lehnardt wrote:
>> All good suggestions, I'd say go for it if no one objects.I too
>> feel the Wiki
>> to be a tad disorganised and thus not very approachable for newbies.
>> (Note, I am not blaming anyone as I am partially responsible for the
>> mess myself :)
>
> I'm not blaming anyone either, but I was wondering if our dear
> Apache hosts supported a feature to export a snapshot of the wiki to
> a tarball? I'm just back from a week-end in the Alps where no
> internet connection has boldly gone before, and downloadable docs
> would've beat the panicked quality time I spent with wget just
> before leaving.
Too bad the wiki isn't built on CouchDB. It would make that easy :)
>
>
> --
> Robin Berjon - http://berjon.com/
>
>
>
Re: wiki proposal
Posted by Robin Berjon <ro...@berjon.com>.
On Jul 1, 2008, at 11:05 , Jan Lehnardt wrote:
> All good suggestions, I'd say go for it if no one objects.I too feel
> the Wiki
> to be a tad disorganised and thus not very approachable for newbies.
> (Note, I am not blaming anyone as I am partially responsible for the
> mess myself :)
I'm not blaming anyone either, but I was wondering if our dear Apache
hosts supported a feature to export a snapshot of the wiki to a
tarball? I'm just back from a week-end in the Alps where no internet
connection has boldly gone before, and downloadable docs would've beat
the panicked quality time I spent with wget just before leaving.
--
Robin Berjon - http://berjon.com/
Re: wiki proposal
Posted by Jan Lehnardt <ja...@apache.org>.
On Jul 1, 2008, at 10:54, Benoit Chesneau wrote:
> Hi all,
>
> While doing translation of the wiki in french, it come to my mind that
> the wiki could be better organized.
>
> For now, we have some proposals mixed with the reference doc, Install
> doc is after the reference where it should be first imho, before
> "started" pages. On the other hand, future of couchdb, proposals,
> hacks and projects around couchdb are mixed everywhere in the doc.
>
> What I thought is a structure of the wiki like this :
>
> 1) Install CouchDB
> 2) Start with with CouchDB
> 3) Reference/ CouchDB API (and only reference)
> 4) Couchdb
> - About
> - FAQ
> - Future
> - Proposals
> 5) Around CouchDB :
> - In the wild
> - Projects
> - Hacks/ Forks
>
> Something like it. What do you think about it ? Any other
> suggestions ?
All good suggestions, I'd say go for it if no one objects.I too feel
the Wiki
to be a tad disorganised and thus not very approachable for newbies.
(Note, I am not blaming anyone as I am partially responsible for the
mess myself :)
And one more time on the record: You did a great job with the
translation,
thanks :)
Cheers
Jan
--