(This is a repost in order to start this thread in the wiki mailing list. Sorry for the noise.)
Hey everyone,
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.
Thank you, -- Aaron Faanes
On Tue, Jun 22, 2010 at 06:48:04PM -0500, Aaron Faanes wrote:
(This is a repost in order to start this thread in the wiki mailing list. Sorry for the noise.)
Hey everyone,
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.
You can't even begin to understand how awesome I think this page is. :)
Most of this has been consensus thusfar, but you've written it down. That's great. I've made a few changes based on what I've seen us do around here (properly), and then you should '''be bold''' and merge this stuff into the current policy pages.
+1 to ian :)
On Wed, Jun 23, 2010 at 1:06 PM, Ian Weller ian@ianweller.org wrote:
On Tue, Jun 22, 2010 at 06:48:04PM -0500, Aaron Faanes wrote:
(This is a repost in order to start this thread in the wiki mailing list. Sorry for the noise.)
Hey everyone,
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.
You can't even begin to understand how awesome I think this page is. :)
Most of this has been consensus thusfar, but you've written it down. That's great. I've made a few changes based on what I've seen us do around here (properly), and then you should '''be bold''' and merge this stuff into the current policy pages.
-- Ian Weller ian@ianweller.org () ascii ribbon campaign - against html e-mail /\ www.asciiribbon.org - against proprietary attachments
wiki mailing list wiki@lists.fedoraproject.org https://admin.fedoraproject.org/mailman/listinfo/wiki
On Tue, Jun 22, 2010 at 8:07 PM, Jose Manimala josemanimala@gmail.com wrote:
+1 to ian :)
On Wed, Jun 23, 2010 at 1:06 PM, Ian Weller ian@ianweller.org wrote:
On Tue, Jun 22, 2010 at 06:48:04PM -0500, Aaron Faanes wrote:
(This is a repost in order to start this thread in the wiki mailing list. Sorry for the noise.)
Hey everyone,
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.
You can't even begin to understand how awesome I think this page is. :)
Most of this has been consensus thusfar, but you've written it down. That's great. I've made a few changes based on what I've seen us do around here (properly), and then you should '''be bold''' and merge this stuff into the current policy pages.
-- Ian Weller ian@ianweller.org () ascii ribbon campaign - against html e-mail /\ www.asciiribbon.org - against proprietary attachments
wiki mailing list wiki@lists.fedoraproject.org https://admin.fedoraproject.org/mailman/listinfo/wiki
-- Kind Regards Jose M Manimala(ജൊസ് മനിമല) http://josemanimala.eu.org Ph: +64221033100 GPGkeyID: 1BE49F39 _______________________________________________ wiki mailing list wiki@lists.fedoraproject.org https://admin.fedoraproject.org/mailman/listinfo/wiki
I really appreciate the kind words about the style guide. :)
I ended up moving it here:
https://fedoraproject.org/wiki/Help:Style_guide
I'm going to try to integrate it a bit with the other editing help pages. Here's a very sketchy outline of the responsibilities (let me know if I missed any):
Help:Editing - Basic information on how to edit on the Fedora Wiki, prominent links to other pages Help:Wiki_syntax_and_markup - Describes syntax from neutral POV Help:Style_guide - Style rules, especially for things that are unique to Fedora Help:Wiki_rules_and_etiquette - Guidelines for friendly user interaction and how to make appropriate edits Help:Wiki_structure - Describes the organization between pages.
AFAIK, this is more or less how it is now, so my work would be shifting content so it's in the right place. For example, some organizational stuff in my guide seems better suited to live in the Wiki_structure page. It also seems like Karsten's link to marking up technical terms is better suited to being in the style guide.
I wonder as well if these pages could be renamed in the interests of consistency. The easiest one would be to rename Style_guide to Wiki_style_guide. However, I wonder if the "Wiki" is redundant, since the Help: namespace seems to imply Wiki-specific information. Perhaps:
Help:Editing Help:Syntax Help:Style Help:Etiquette Help:Organizing_pages or Help:Structure
This is just a possibility, though, as some of the renamed ones do seem a little too general. I was curious what you guys think about this, and especially the page responsibilities.
-- Aaron Faanes
On Wed, Jun 23, 2010 at 11:41:01AM -0500, Aaron Faanes wrote:
I'm going to try to integrate it a bit with the other editing help pages. Here's a very sketchy outline of the responsibilities (let me know if I missed any):
Help:Editing - Basic information on how to edit on the Fedora Wiki, prominent links to other pages Help:Wiki_syntax_and_markup - Describes syntax from neutral POV
We don't need to worry too much about NPOV rules here, but I guess they wouldn't hurt.
Help:Style_guide - Style rules, especially for things that are unique to Fedora Help:Wiki_rules_and_etiquette - Guidelines for friendly user interaction and how to make appropriate edits Help:Wiki_structure - Describes the organization between pages.
AFAIK, this is more or less how it is now, so my work would be shifting content so it's in the right place. For example, some organizational stuff in my guide seems better suited to live in the Wiki_structure page. It also seems like Karsten's link to marking up technical terms is better suited to being in the style guide.
I wonder as well if these pages could be renamed in the interests of consistency. The easiest one would be to rename Style_guide to Wiki_style_guide. However, I wonder if the "Wiki" is redundant, since the Help: namespace seems to imply Wiki-specific information. Perhaps:
Help:Editing Help:Syntax Help:Style Help:Etiquette Help:Organizing_pages or Help:Structure
This is just a possibility, though, as some of the renamed ones do seem a little too general. I was curious what you guys think about this, and especially the page responsibilities.
+1 to all of this -- this is something we've needed for a really long time that I just haven't had time to put forth. Thanks so much for your work!