You are viewing a plain text version of this content. The canonical link for it is here.
Posted to marketing@couchdb.apache.org by Robert Kowalski <ro...@kowalski.gd> on 2015/05/12 00:37:44 UTC

CouchDB website: contributing redesign / text help

Hi!

I recently presented a small idea on the website mailing list, it is
about making it more visual how many subprojects we have that require
so many different skillsets [1]

I teamed up with ermouth and we created a new contribution section
with cards that describe the many subprojects we have [2]. It gives a
quick overview about the many ways you can get engaged in the CouchDB
project. To be honest, ermouth did all the hard work.

We need your help! You might have noticed that our texts are not
perfect. We have a main intro text and texts on the cards. For the
cards every text can be up to 4-5 lines in our cards. They are short
slogans that should describe the project and also attract new
contributors.

Please take a look at our preview [2]!

Best,
ermouth & Robert


[1] http://mail-archives.apache.org/mod_mbox/couchdb-www/201505.mbox/%3CCAJ1bcfExgZJiD%3DLsQrxmDVNodaFdGZS0ZYftHpn%2B4g2cHb-MfA%40mail.gmail.com%3E

[2] http://robertkowalski.github.io/couchdb-www/#contribute

Re: CouchDB website: contributing redesign / text help

Posted by ermouth <er...@gmail.com>.
Shortened texts, put new version as a comment
https://gist.github.com/nolanlawson/09cab7798aed9ec9044c

Waiting for Nolan review.

ermouth

2015-05-12 21:55 GMT+03:00 Robert Kowalski <ro...@kowalski.gd>:

> Very good texts!
>
> As ermouth already mentioned: Fauxton and Website are OK, the others
> are a bit too long (I tried out and put the texts in the cards)
>
> On Tue, May 12, 2015 at 8:05 PM, ermouth <er...@gmail.com> wrote:
> >>> Here’s one: https://gist.github.com/nolanlawson/09cab7798aed9ec9044c
> >> Any thoughts?
> >
> > Good, but too long – we need less adjectives.
> >
> > Fauxton and Website are ok, all others definitely do not fit.
> >
> > ermouth
>

Re: CouchDB website: contributing redesign / text help

Posted by Robert Kowalski <ro...@kowalski.gd>.
Very good texts!

As ermouth already mentioned: Fauxton and Website are OK, the others
are a bit too long (I tried out and put the texts in the cards)

On Tue, May 12, 2015 at 8:05 PM, ermouth <er...@gmail.com> wrote:
>>> Here’s one: https://gist.github.com/nolanlawson/09cab7798aed9ec9044c
>> Any thoughts?
>
> Good, but too long – we need less adjectives.
>
> Fauxton and Website are ok, all others definitely do not fit.
>
> ermouth

Re: CouchDB website: contributing redesign / text help

Posted by ermouth <er...@gmail.com>.
>> Here’s one: https://gist.github.com/nolanlawson/09cab7798aed9ec9044c
> Any thoughts?

Good, but too long – we need less adjectives.

Fauxton and Website are ok, all others definitely do not fit.

ermouth

Re: CouchDB website: contributing redesign / text help

Posted by Jan Lehnardt <ja...@apache.org>.
> On 12 May 2015, at 16:57, Alexander Shorin <kx...@gmail.com> wrote:
> 
> On Tue, May 12, 2015 at 5:51 PM, Jan Lehnardt <ja...@apache.org> wrote:
>>> On 12 May 2015, at 14:29, Jan Lehnardt <ja...@apache.org> wrote:
>>> 
>>>> 
>>>> On 12 May 2015, at 14:22, ermouth <er...@gmail.com> wrote:
>>>> 
>>>>> I left my suggestions here:
>>>>> Here are my suggestions:
>>>> 
>>>> Collegues, if you have someone who is a) native English speaker, b) has
>>>> skills in writing good copy – could you please ask him/her to review the
>>>> source?
>>> 
>>> Good call, let’s see: https://twitter.com/janl/status/598102651222523904 :)
>> 
>> Here’s one: https://gist.github.com/nolanlawson/09cab7798aed9ec9044c
> 
> All is perfect! But CouchDB Core text need to be a bit improved:
> 
>> Help shape the future of CouchDB! There's still plenty of exciting work to be done on the core database. We use modern tools like JIRA and Github to track issues and pull requests.
> 
> Future of CouchDB is shaped not only by core,

The text doesn’t claim that the core *only* shapes the future and the fact that the other areas of contributions are right there next to it should make that clear.

> but Fauxton, Docs,
> Marketings and all the other cards as well.  Statement about "we use
> ... JIRA and Github to track issues and pull requests" may be read as
> "We use two issues trackers and that why we have a lot of work to do”.

Heh, nice catch, I hadn’t read it that way, maybe we can rephrase the
whole thing? :)

I think the intention is 1. “we have a lot to do” 2. “we use standard tools that you are familiar with to work”

Best
Jan
--

> 
> Any thoughts?
> 
> --
> ,,,^..^,,,

-- 
Professional Support for Apache CouchDB:
http://www.neighbourhood.ie/couchdb-support/

Re: CouchDB website: contributing redesign / text help

Posted by Alexander Shorin <kx...@gmail.com>.
On Tue, May 12, 2015 at 5:51 PM, Jan Lehnardt <ja...@apache.org> wrote:
>> On 12 May 2015, at 14:29, Jan Lehnardt <ja...@apache.org> wrote:
>>
>>>
>>> On 12 May 2015, at 14:22, ermouth <er...@gmail.com> wrote:
>>>
>>>> I left my suggestions here:
>>>> Here are my suggestions:
>>>
>>> Collegues, if you have someone who is a) native English speaker, b) has
>>> skills in writing good copy – could you please ask him/her to review the
>>> source?
>>
>> Good call, let’s see: https://twitter.com/janl/status/598102651222523904 :)
>
> Here’s one: https://gist.github.com/nolanlawson/09cab7798aed9ec9044c

All is perfect! But CouchDB Core text need to be a bit improved:

> Help shape the future of CouchDB! There's still plenty of exciting work to be done on the core database. We use modern tools like JIRA and Github to track issues and pull requests.

Future of CouchDB is shaped not only by core, but Fauxton, Docs,
Marketings and all the other cards as well.  Statement about "we use
... JIRA and Github to track issues and pull requests" may be read as
"We use two issues trackers and that why we have a lot of work to do".

Any thoughts?

--
,,,^..^,,,

Re: CouchDB website: contributing redesign / text help

Posted by Jan Lehnardt <ja...@apache.org>.
> On 12 May 2015, at 14:29, Jan Lehnardt <ja...@apache.org> wrote:
> 
>> 
>> On 12 May 2015, at 14:22, ermouth <er...@gmail.com> wrote:
>> 
>>> I left my suggestions here:
>>> Here are my suggestions:
>> 
>> Collegues, if you have someone who is a) native English speaker, b) has
>> skills in writing good copy – could you please ask him/her to review the
>> source?
> 
> Good call, let’s see: https://twitter.com/janl/status/598102651222523904 :)

Here’s one: https://gist.github.com/nolanlawson/09cab7798aed9ec9044c

I like it :)

Best
Jan
--

> 
> Best
> Jan
> --
> 
>> 
>> Both @Jan and @Alexander texts have good subtle moments – but they both are
>> not enough good for landing, sorry. As well as my texts.
>> 
>> May be @Johs could help? His biz requires strong copy skills, so may be he
>> has someone in-staff?
>> 
>>> "Help us" sounds like as we're in catastrophic position (:
>> 
>> I decided 2 cries are acceptable, 3 is too much )
>> 
>> ermouth
> 
> -- 
> Professional Support for Apache CouchDB:
> http://www.neighbourhood.ie/couchdb-support/

-- 
Professional Support for Apache CouchDB:
http://www.neighbourhood.ie/couchdb-support/

Re: CouchDB website: contributing redesign / text help

Posted by Jan Lehnardt <ja...@apache.org>.
> On 12 May 2015, at 14:22, ermouth <er...@gmail.com> wrote:
> 
>> I left my suggestions here:
>> Here are my suggestions:
> 
> Collegues, if you have someone who is a) native English speaker, b) has
> skills in writing good copy – could you please ask him/her to review the
> source?

Good call, let’s see: https://twitter.com/janl/status/598102651222523904 :)

Best
Jan
--

> 
> Both @Jan and @Alexander texts have good subtle moments – but they both are
> not enough good for landing, sorry. As well as my texts.
> 
> May be @Johs could help? His biz requires strong copy skills, so may be he
> has someone in-staff?
> 
>> "Help us" sounds like as we're in catastrophic position (:
> 
> I decided 2 cries are acceptable, 3 is too much )
> 
> ermouth

-- 
Professional Support for Apache CouchDB:
http://www.neighbourhood.ie/couchdb-support/

Re: CouchDB website: contributing redesign / text help

Posted by ermouth <er...@gmail.com>.
>I left my suggestions here:
> Here are my suggestions:

Collegues, if you have someone who is a) native English speaker, b) has
skills in writing good copy – could you please ask him/her to review the
source?

Both @Jan and @Alexander texts have good subtle moments – but they both are
not enough good for landing, sorry. As well as my texts.

May be @Johs could help? His biz requires strong copy skills, so may be he
has someone in-staff?

> "Help us" sounds like as we're in catastrophic position (:

I decided 2 cries are acceptable, 3 is too much )

ermouth

Re: CouchDB website: contributing redesign / text help

Posted by Alexander Shorin <kx...@gmail.com>.
I left my suggestions here:
https://github.com/robertkowalski/couchdb-www/pull/1

TL;DR don't beg for help, attract people curiosity to help. A lot of
"Help us" sounds like as we're in catastrophic position (:
--
,,,^..^,,,


On Tue, May 12, 2015 at 1:22 PM, Jan Lehnardt <ja...@apache.org> wrote:
> This is awesome!
>
> Here are my suggestions:
>
>
> CouchDB Core
>
> Help to shape the future of CouchDB. Work on the core database, there is a lot of work to do. We use JIRA to track issues and GitHub for Pull Requests.
>
>
>
> Fauxton (no change)
>
> Help us to build the next generation Web UI for CouchDB — the component that makes CouchDB so powerful and easy to manage.
>
>
> Marketing
>
> Work with us on The CouchDB Story. Help with the organisation of how we promote CouchDB — plan meetups, write articles.
>
>
> Website (no change)
>
> Help to improve site you are now viewing. Familiar with web design? Think UX, copy or layout could be better? Welcome!
>
>
> Documentation
>
> Docs are vital to any open source project. And they can be improved indefinitely. Help to make the docs more clear, better structured, or translate them into your native language.
>
>
> Guidance (no change)
>
> Be the first person someone interacts with when they have a problem. This is a great way to help out while learning more about the project.
>
>
>
>> On 12 May 2015, at 00:37, Robert Kowalski <ro...@kowalski.gd> wrote:
>>
>> Hi!
>>
>> I recently presented a small idea on the website mailing list, it is
>> about making it more visual how many subprojects we have that require
>> so many different skillsets [1]
>>
>> I teamed up with ermouth and we created a new contribution section
>> with cards that describe the many subprojects we have [2]. It gives a
>> quick overview about the many ways you can get engaged in the CouchDB
>> project. To be honest, ermouth did all the hard work.
>>
>> We need your help! You might have noticed that our texts are not
>> perfect. We have a main intro text and texts on the cards. For the
>> cards every text can be up to 4-5 lines in our cards. They are short
>> slogans that should describe the project and also attract new
>> contributors.
>>
>> Please take a look at our preview [2]!
>>
>> Best,
>> ermouth & Robert
>>
>>
>> [1] http://mail-archives.apache.org/mod_mbox/couchdb-www/201505.mbox/%3CCAJ1bcfExgZJiD%3DLsQrxmDVNodaFdGZS0ZYftHpn%2B4g2cHb-MfA%40mail.gmail.com%3E
>>
>> [2] http://robertkowalski.github.io/couchdb-www/#contribute
>
> --
> Professional Support for Apache CouchDB:
> http://www.neighbourhood.ie/couchdb-support/
>

Re: CouchDB website: contributing redesign / text help

Posted by Jan Lehnardt <ja...@apache.org>.
This is awesome!

Here are my suggestions:


CouchDB Core

Help to shape the future of CouchDB. Work on the core database, there is a lot of work to do. We use JIRA to track issues and GitHub for Pull Requests.



Fauxton (no change)

Help us to build the next generation Web UI for CouchDB — the component that makes CouchDB so powerful and easy to manage.


Marketing

Work with us on The CouchDB Story. Help with the organisation of how we promote CouchDB — plan meetups, write articles.


Website (no change)

Help to improve site you are now viewing. Familiar with web design? Think UX, copy or layout could be better? Welcome!


Documentation

Docs are vital to any open source project. And they can be improved indefinitely. Help to make the docs more clear, better structured, or translate them into your native language.


Guidance (no change)

Be the first person someone interacts with when they have a problem. This is a great way to help out while learning more about the project.



> On 12 May 2015, at 00:37, Robert Kowalski <ro...@kowalski.gd> wrote:
> 
> Hi!
> 
> I recently presented a small idea on the website mailing list, it is
> about making it more visual how many subprojects we have that require
> so many different skillsets [1]
> 
> I teamed up with ermouth and we created a new contribution section
> with cards that describe the many subprojects we have [2]. It gives a
> quick overview about the many ways you can get engaged in the CouchDB
> project. To be honest, ermouth did all the hard work.
> 
> We need your help! You might have noticed that our texts are not
> perfect. We have a main intro text and texts on the cards. For the
> cards every text can be up to 4-5 lines in our cards. They are short
> slogans that should describe the project and also attract new
> contributors.
> 
> Please take a look at our preview [2]!
> 
> Best,
> ermouth & Robert
> 
> 
> [1] http://mail-archives.apache.org/mod_mbox/couchdb-www/201505.mbox/%3CCAJ1bcfExgZJiD%3DLsQrxmDVNodaFdGZS0ZYftHpn%2B4g2cHb-MfA%40mail.gmail.com%3E
> 
> [2] http://robertkowalski.github.io/couchdb-www/#contribute

-- 
Professional Support for Apache CouchDB:
http://www.neighbourhood.ie/couchdb-support/