Help:Talk pages

From Gentoo Wiki
(Redirected from Gentoo Wiki:Discussion)
Jump to:navigation Jump to:search

Every wiki page has an associated talk page which can be used for discussion about the wiki and for communicating with other users. Talk pages can be accessed by clicking the “discussion” tab at the top of the page. Talk pages are edited like other wiki pages, even for adding comments or sections (a new section may also be added via a form, by pressing the "+" link in the "more" menu).

An article's talk page is used to discuss the wiki contents. These talk pages focus on the task of building a wiki article, and are provided to support this process - the topic of conversation should generally revolve around what needs to be done to make the associated article better. These talk pages are not a place for other topics, such as support requests.

A user talk page is a place to leave messages for a particular wiki user.

Talk pages are a good place to suggest a correction or a modification to an article, though it is often preferable to edit an article directly. By editing an article directly, rather than spending time waiting for replies and discussing changes, content - even if imperfect - is added to the wiki, and gives other editors the chance to improve it. At worst an edit will be reverted, and some discussion can still occur in the edit summeries. If input from other editors is required, talk pages are the place to ask.

Note
Documentation suggestions and corrections concerning packages maintained as Gentoo projects can be reported to bugs.gentoo.org. Reporting issues on bugs.gentoo.org should inform the appropriate developers and maintainers, and allow issues to be formally tracked. If an issue can be reported to bugs.gentoo.org, please do, though a comment on the wiki is better than nothing. Wiki-specific subjects, i.e. things not followed by bugs.gentoo.org, should still use talk pages and direct edits.

Technically, a talk page is very similar to any other wiki page, but it is in the “Talk” namespace, to keep it separate from the articles in the “(Main)” namespace (see Help:namespaces). As with any wiki page, it can be edited, linked to, and has an edit history.

Using talk pages

Having discussions on a free-form wiki page may seem strange at first, though it works well for the purpose. The freedom provided by this model means that some simple editing conventions should be followed in order to keep things clear for everybody.

A series of comments make up a discussion, which comes under a section heading. When adding a comment:

  • Always sign comments. Use the four tildes “~~~~” wiki syntax (or the signature button signature button in the toolbar). See Help:Signatures.
  • Add new comments below older ones.
  • Indent replies with colons (:) at the beginning of the line.

When starting a new discussion, create a new section:

  • Add new discussions at the bottom of the page.
  • Start a new discussion with a ==level 2 heading==.
  • Mark any new section as "open for discussion" by using the {{Talk}} template: {{talk|open}}. This indicates that the conversation is still ongoing, so that it will show up in the list of open discussions. Remember to close discussions as soon as appropriate.


To add the very first section and comment to a talk page, the page must be created. Please place the {{Talk page}} template at the top of a new talk page.

Starting off, to get an idea of how talk pages work, it may help to have a look at the source of larger, preexisting talk pages.

Example

Here is an example discussion, following the talk page conventions:

Wiki text Rendered talk page

== More spiders information needed ==
This page has a lot of detail about the web, but I really dont understand a single word of it, and it doesn't mention the spider once -- [[User:Example|Bob Smith]] 18:07, 26 August 1991 (UTC)
: No no. This page is talking about the "world wide web". I have added a clarification at the top - [[User:Example|Simon Brown]] 11:21, 28 August 1991(UTC)
:: Oh I see... So what's the big deal about hyperlinked documents? Seems like a stupid idea to me. -- [[User:Example|Bob Smith]] 14:11, 3 September 1991 (UTC)
::: Well I think we should have some information about it here on our wiki, but you're probably right. It'll never catch on. -- [[User:Example|Simon Brown]] 21:55, 3 September 1991 (UTC)

More spiders information needed

This page has a lot of detail about the web, but I really dont understand a single word of it, and it doesn't mention the spider once -- Bob Smith 18:07, 26 August 1991 (UTC)

No no. This page is talking about the "world wide web". I have added a clarification at the top - Simon Brown 11:21, 28 August 1991(UTC)
Oh I see... So what's the big deal about hyperlinked documents? Seems like a stupid idea to me. -- Bob Smith 14:11, 3 September 1991 (UTC)
Well I think we should have some information about it here on our wiki, but you're probably right. It'll never catch on. -- Simon Brown 21:55, 3 September 1991 (UTC)

Editing discussions

Having discussions on a free-form wiki page may seem unusual to many new users, but it has some advantages over the conventional rigid forum format, even if it can get a little messy if everybody isn't careful. As with other wiki pages, anyone can help with tidying up discussions, to make them conform to the editing conventions, e.g. add signatures and headings where they are missing.

Though it is possible to edit other user's comments, it is usually bad etiquette to modify somebody else's wording. If a preexisting comment were to need clarification, it is best to just add a subsequent comment referencing any corrections.

If needed, it can sometimes be acceptable to:

Modify discussion headings
Change wording or append words to discussion headings, to better describe the topic of discussion. Note that good descriptive headings become important when many discussions start to fill the page.
Move discussions to a different page
If discussions are put in the wrong place on the wiki, and would be better associated with a different talk page, then a discussion may be moved by cut & paste. This has the potential to create confusion, but can be important for keeping things tidy. To avoid any confusion, leave a link to the new discussion, explaining that it was moved and why.
Delete discussions when they are out-of-date
Discussions can often get left lying around on a talk page long after the issue is no longer relevant. It's usually a good idea to reply to saying "I think this is now resolved", but sooner or later it's time to just blow away the old discussions (they are of course preserved in the editing history).
Split a post into several discussions
It may be appropriate to do this, if somebody has raised several points which need to be answered separately. However, please always be respectful to other people's words. Does their post still make sense if split up?

The {{Unsigned}} template may be added to comments if a user has forgotten to sign their comment.

Direct edition advantages

Remember that editing an article itself is often a more effective means of communicating. Wiki editing may be a little more work than just adding a freestyle comment to a talk page, requiring a little editing knowledge, editorial effort, and that any points of view be assured to be balanced. Directly editing the wiki is often more productive for the community however, even with content that is not perfect, and will not remain the definitive version.

It may often feel more natural to engage in any debate on a talk page (or indeed through any other contact channel), but a wiki article itself can offer a powerful means of reaching middle-ground. On issues that may not be clear cut, think about how to portray both sides of the argument (e.g. listing advantages and disadvantages) and any debate will often simply evaporate. Remember that the wiki does not deal in opinion - consider that opinions will diverge, while fact will tend to consensus.

Comments on talk pages may take a little longer to get a reply. An edit to the wiki will usually provoke a rapid editorial response, if one is needed - it also has the advantage or committing new content straight to where it is useful.

Even lesser-quality edits to the wiki will allow other editors to use the addition as a base for a more appropriate change, or to inspire a more in-depth edit. Do not worry about "breaking things", at worst an edit will simply be reverted. During the whole process, some discussion can occur through the edit summaries, to make intentions clear, and iron out details.

User talk pages

A "user talk page" is a talk page associated with somebody's "user page" (See Help:User page). This is a place to leave messages for a particular wiki user.

This can function as a kind of messaging system. Users receive the following prominent notification when new messages have been left on their talk page:

The message will continue to be displayed on all pages until users visit their talk page.

They may be notified by email as well, although this cannot always be relied upon (since the email notification feature must be activated by supplying a valid email address, and clicking a confirmation link). If no response is received to a user talk page message, try looking for other contact details which may have been supplied on the user page.

Important
Messages are not private, other users can view and join in the conversation.

Closing discussions

When there is nothing to add to a conversation, please close the discussion using the {{Talk}} template: {{talk|done|date=yyyy-mm-dd}}.

It is important to close discussions, because when left open they remain listed on the open discussions page. That page is meant as a place to get an overview of current conversations on the wiki, so it is more conducive to dynamic collaboration to maintain a reasonable number of active conversations, without the list being cluttered up with "stale" discussions.

Remember that talk pages are there for discussing article contents, with a view to move along the process of building better articles. It therefore should generally hold that the quicker a discussion is resolved, and closed, the better.

See also