Re: Fedora wiki style guide

[Karsten Wade]

On Tue, Jun 22, 2010 at 05:31:46PM -0400, Ian Weller wrote:
>  On Tue, Jun 22, 2010 at 01:12:03PM -0500, Aaron Faanes wrote:
>  > I've been working a lot with the Fedora wiki recently, and I've been
>  > accumulating some style ideas as I've been editing. I ended up writing
>  > some of my thoughts and suggestions:
>  > 
>  > https://fedoraproject.org/wiki/User:Dafrito/Style_guide
>  > 
>  > I'm interested in what you guys have to think about it - especially in
>  > what sections represent areas of consensus or disagreement.
>  > 
>  > The guide uses a formal voice for clarity, but I intend for any
>  > guideline to be friendly, incremental, and flexible. It's not an
>  > all-or-nothing proposal. :) I mean no offense to any other editors,
>  > and I apologize in advance if I appear rude in the document.
>  
>  This is very good. There's a few things that I'm going to change on it.
>  Would you mind subscribing to the wiki list and posting this there, too?
>  
>  https://admin.fedoraproject.org/mailman/listinfo/wiki 
Oh, yes, definitely, bring it over.  (I'm switching my Cc: and will
join the thread later, too.)

Aaron, you are very much on the mark here.  There is desire to adopt
exactly the sort of conventions you write down.  There is some inertia
to deal with, but we can work through that.  We've long stated that
our *goal* is to be "do it like Wikipedia says to do it, except in
these ways ..." and have a few, reasoned exceptions if necessary.

For example, this page is specifically useful if you are writing in a
MediaWiki syntax and want to convert later to DocBook XML:

http://fedoraproject.org/wiki/Help:Wiki_syntax_and_markup#Marking_Technic...

Those I would call guidelines on top of how to do things the Wikipedia
way, and really most useful in the DocBook situation.  However, having
matching technical markup usage across the site would be a good thing
anyway ...

- Karsten
-- 
name:  Karsten 'quaid' Wade, Sr. Community Gardener
team:                Red Hat Community Architecture 
uri:               http://TheOpenSourceWay.org/wiki
gpg:                                       AD0E0C41