Help:Editing pages

From Gentoo Wiki
Jump to:navigation Jump to:search

It is very easy to edit the contents of the wiki: with an account in hand, it only takes a few clicks! This article describes the Edit function of wiki pages. See the contributor's guide and other help pages on how to contribute to the wiki for how to edit pages and provide content.

Edits should preferably be short so that glancing over the recent changes and the edit summary can give an idea of the reasoning behind them. It is usually preferable to make one edit per section at a time, if possible. An ideal edit often has a specific impetus to it, and makes clear how it makes things better. Other editors need to be able to understand why things were changed to be able to decide if an edit should be kept or not.

Edit box

Enter changes to wiki source text here, following the Gentoo wiki guidelines. There is also a "visual" editor available.

Edit summary

Enter a short description of changes in the "Summary:" box, just a quick reference for other editors to know what was done in an edit.

The summary gets stored alongside the edit, and allows other contributors to track changes in the wiki more effectively. Changes might not be obvious, so the goal of this field is to describe the changes and the reason behind them at a glance.

For very small changes that can't reasonably need any further work, such as fixing links, punctuation, or typos, please check the This is a minor edit box. This will allow other editors to concentrate on larger modifications when checking over what is going on in the wiki.

Internal wiki links using square brackets ([[page name]]) can be used in the summary, and they will be displayed as clickable links to other readers.


The "Show preview" button will show what a page will look like once it is saved, but without actually saving it. This is helpful to see what a page will look like before saving to check for obvious mistakes.

Show changes

The "Show changes" button previews the differences between the existing version and the edited version. This feature can help to determine what information to include in the edit summary.

Save changes

This button will commit the modified article to the wiki. Make sure to have confirmation after clicking: depending on the configuration, it may ask to properly fill in the edit summary before effectively saving. Some content may refuse to save, such as incorrect links to internal wiki pages - correct any errors before saving.

Source comments

It can be helpful to leave comments in the wiki source both as an aide-mémoire and for other editors:

<!-- Note about content to remind everyone of why things were done like this -->

Editors will see the notes either in the source code or represented in the visual editor, they will not be displayed when reading the page.

The {{Ednote}} template may be used to draw attention to particularly important points.

Watch this page

Select this check box to add the page to the user's watchlist on saving.

See also