Difference between revisions of "Help:Funtoo Editing Guidelines"

Before we get started, it's a good idea to review what kinds of changes to the wiki we're looking for, and what kind of changes we're not looking for.

Most of the time it's good to document stuff. But because we want Funtoo Linux to be as seamless an experience as possible, sometimes the best approach is to use IRC or forums for support, or file a bug on our bug tracker.

Type of Change	Okay?
Grammar/spelling fixes	Yes
New wiki content	Yes
New package information	Yes
Adding to existing article	Maybe -- see below
Adding missing/incomplete information	Yes
Making corrections	Yes
Adding work-arounds to problems experienced	No - open bug first on bug tracker.

@@ Line 11: / Line 11: @@
 Before we get started, it's a good idea to review what kinds of changes to the wiki
-we're looking for, and what kind of changes we're not looking for. While we love wiki contributions, the wiki can be used in a way that is not ideal. Generally, anything that isn't a ''workaround for a problem you are experiencing'' is generally fair game for the wiki. Here are the types of changes
+we're looking for, and what kind of changes we're not looking for.
-that are OK and not OK:
+Most of the time it's good to document stuff. But because we want Funtoo Linux to be as seamless an experience as possible, sometimes the best approach is to use IRC or forums for support, or file a bug on our bug tracker.
 {{TableStart}}
@@ Line 24: / Line 25: @@
 <tr class="danger"><td>Adding work-arounds to problems experienced</td><td>No - open bug first on [https://bugs.funtoo.org bug tracker].</td></tr>
 {{TableEnd}}
-So, make a mental note -- if you experience some problem with Funtoo Linux, during installation or otherwise, the proper course of action is to not add a work-around to our documentation, but to ''open a bug on our bug tracker'', or if your problem is potentially a support issue, ask for help on IRC or our forums. This is important because the problem you experienced may be a legitimate bug and the solution may be to fix the bug rather than add a work-around to our documentation, or the problem may be an issue that requires support rather than an actual documentation fix.
 [[Category:Wiki Development]]
 [[Category:Official Documentation]]

Difference between revisions of "Help:Funtoo Editing Guidelines"

Revision as of 04:02, February 24, 2019

Navigation menu

Search