What to do when noticing an error on the wiki
Contributor's guide — Guidelines — Fixing errors howto
Editing pages — Talk pages — Formatting
Code of conduct — Wiki project page — About Gentoo wiki — Wiki FAQ
Help improve the documentation! — Contributing to Gentoo
There may occasionally be errors on the wiki, as the volume of documentation managed here means some things will inevitably slip through. Anyone reading the wiki who comes across an error can help fix things though! Here are instructions on what to do when noticing an error on the wiki, to get things fixed.
Please use the just fix it option, if at all possible. It's quick, and means the least work for an already overstretched team ;).
Some pages are protected and not publicly editable, and will have a "view source" button in place of the "Edit" buttons. For these pages, please flag issues on the relevant talk page.
The contributor's guide explains how to start editing articles. See help improve Gentoo by getting involved with documentation! for a full introduction on how to help out on the wiki.
Just fix it
The most useful thing that can be done about an issue on the wiki is to create an account, if not already done, and just fix the issue directly on the wiki! This is the best thing anyone can do to help out around here. Don't worry too much about formatting, or the quality of the English - editors can touch this up later - the main thing is to get erroneous information removed from the wiki.
Even an imperfect solution can be fixed up by editors later, so don't worry about making things absolutely flawless. If an edit is short, and makes things better than they were before, it should be a good contribution, at least to work from. Just refrain from making large edits, as these can be hard to untangle.
Check out the contributor's guide for more information on creating accounts, on how to start editing the wiki, and on how to make the best additions possible. If making more substantial edits to the wiki, please do be sure to check out that guide, and the official wiki guidelines.
Flag the issue on talk pages
If a solution to a problem found in an article isn't immediately apparent, please do still leave a note on the offending article's talk page to inform everyone of the issue. This way another editor can come along and fix it, or the team can ask for follow-up information on what is wrong.
Inform editors of issues on protected pages and propose solutions
Pages such as the handbook and project pages have editing restricted to try to ensure quality.
Any changes needed to these protected pages should be added to a new section of the relevant talk page. If possible, please do propose a solution to any issues with the {{Proposal}} template:
Type | To get |
---|---|
{{Proposal|section=Doing the things|The new way to do things is with this tool in this place...}}
|
Proposed changes to section Doing the things - Please make edits here until a final revision is agreed upon.
The new way to do things is with this tool in this place... |
It is very useful when flagging issues on protected pages to propose a fix on the corresponding talk page with the {{Proposal}} template. This can both make things clearer as to what the issue is, and save time for the editors.
If all else fails
There are always other ways to help get an issue fixed, so here are a couple for reference, but please do just fix things directly or use the talk pages if a discussion is really needed.
IRC in #gentoo-wiki
Though the above solutions are preferable, it is possible to come and tell us on IRC about an issue, on the #gentoo-wiki (webchat) channel. Please only do this as a final recourse, as it is much easier for the wiki team to organize their work when things are clearly stated on talk pages, and this avoids things being forgotten or missed (not everybody has time to constantly monitor the IRC channel).
Contact wiki team by email
If there really isn't any other way, it's always possible to get in touch with a wiki administrator, for example by email.
See also
- Contributing to Gentoo — explains how users can contribute to the development of Gentoo
- Gentoo Wiki:Contributor's guide — help anyone quickly get started with simple edits
- Gentoo Wiki:Guidelines — provide writing-conventions and layout-schemes that aim for a consistent and professional presentation across all of the wiki's diverse articles
- Help:Contents — provide useful information about using the Gentoo wiki
- Help improve Gentoo by getting involved with documentation! — the areas where anyone can help improve the documentation for the benefit of both Gentoo users and unix(like) users across the Internet
- Special:CreateAccount