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?
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_Technical_...
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
-
Karsten Wade