Mailing-List: contact cloudstack-marketing-help@incubator.apache.org;
 run by ezmlm
Precedence: bulk
Reply-To: cloudstack-marketing@incubator.apache.org
Received-SPF: pass (nike.apache.org: local policy)
From: <kdamage@apache.org>
Sender: "Kelcey Damage \(BT\)" <kelcey@backbonetechnology.com>
To: <cloudstack-marketing@incubator.apache.org>
References: <063001ce15e8$58db8320$0a928960$@backbonetechnology.com>
 <1362079229.12839.140661198319469.6E071AAE@webmail.messagingengine.com>
 <064001ce15e9$fd977d50$f8c677f0$@apache.org>
 <1362080392.16338.140661198326597.7ADA3709@webmail.messagingengine.com>
In-Reply-To: 
 <1362080392.16338.140661198326597.7ADA3709@webmail.messagingengine.com>
Subject: RE: FW: Wiki visual guidlines
Date: Thu, 28 Feb 2013 12:09:42 -0800
Message-ID: <064c01ce15ef$8b8ec640$a2ac52c0$@apache.org>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: 7bit
Thread-Index: AQG0LMI/LwKMP1c4ZrRkGg+LZMRmkwFIVEVeAjoW4DYBaPq5lpicKEJQ
Content-Language: en-us

Here is where it becomes debate.

I fully agree with you, but I also believe (and we are on the marketing
list) that consistency between publically facing article bearing our intent
and branding is key. And leads to the perceived professionalism of our
project.

I don't mind wandering through some pages and updating header types. I
certainly don't want to delay or slow down people fervently writing kickass
wiki articles.

But this brings up another question, what about grammar, etc?

I'm willing to put in a couple hours a week and curate the wiki, but
establishing norms upfront allows people willing to follow guides, the
option.

So really I'm not saying this is firm must follow or die guidelines, but
something for willing. And for those with no time to format, perhaps someone
like me will be willing to format for them? In fact people adding large
content articles could reach out to myself or the list and request
assistance in formatting and review.

Just some ideas.

-Kelcey


>-----Original Message-----
>From: Joe Brockmeier [mailto:jzb@zonker.net]
>Sent: Thursday, February 28, 2013 11:40 AM
>To: cloudstack-marketing@incubator.apache.org
>Subject: Re: FW: Wiki visual guidlines
>
>Hi Kelcey,
>
>On Thu, Feb 28, 2013, at 01:29 PM, kdamage@apache.org wrote:
>> I was just thinking right now I could write a whole page in headers
>> which is silly, and there are 6 default headers, also bullet usage and
>> etc.
>
>Are people doing this, or is this a "it might be a problem, someday"?
>
>I ask because if people are formatting things in a wildly inconsistent
manner
>right now, then we need to deal with that.
>
>If *not* then it seems like being over-proscriptive with style guidelines
might
>be a momentum blocker for someone who's keen on doing some docs on the
>wiki. Not sure "go read the style guidelines first" is in keeping with
"edit
>boldly."
>
>(e.g., I don't want to chastise anyone for using h3 headers instead of h2,
or
>using red instead of green when they're doing good stuff or having the
>impression of putting speed bumps in the way of getting up more
>information.)
>
>Consistency isn't as important as accuracy and completeness, IMHO.
>
>All that said - if there's really wonky, unreadable stuff on the wiki -
then let's
>address that.
>
>Best,
>
>jzb
>--
>Joe Brockmeier
>jzb@zonker.net
>Twitter: @jzb
>http://www.dissociatedpress.net/