Help:Wiki Conventions

This page is a work in progress, and has not yet obtained a solid consensus. It was first created (or significantly revised) on 4 August 2009. Do not take the information on this page as firmly established ISFDB policy or guidelines. Feel free to discuss any issues with the content on this page on its talk page. If in doubt, before accepting the guidelines on this page, feel free to discuss the matter elsewhere, perhaps on the Community Portal. This notice will be removed when the page obtains a reasonable consensus on its contents.

Conventions and Customs of the ISFDB Wiki

Some of these are borrowed from other wikis, particularly Wikipedia, and modified to fit our particular needs and tastes; others have just grown up here.

User Page

The "User Page" associated with a particular User ID is typically used to present some relatively brief information about that User. (It is the page named "User:<UserID>" where <UserID> represents the userID in question. For example, User:DESiegel60 is the User page for the userID "DESiegel60".) Some users also store to-do lists, template or editing skeletons, links to frequently visited pages, or other useful information on their user pages. Some users also make use of Sub-pages of their user pages (pages named something like "User:UserID/Somepage") as experimental pages, places for work-in-progress, or for other purposes. Users are generally fairly free to place almost anything on a user page or user page subpage, subject to What the ISFDB Wiki is not, and the general rule that "The Wiki is a support tool for the ISFDB, and should not be used for anything that is not appropriate for that purpose."

While a user page may, indeed often will, describe a user's off site activities, including the user's professional activities, it should not be used for anything that seems like advertising. Users who are also authors of SF should probably construct a Bio: page, and follow the biography policy and guidelines on the bio page. These guidelines should also be kept in mind when describing a user's activities as an author on a user page.

Even though we speak of "his user page" or "Joe's user page", keep in mind that all Wiki pages, including user pages, are provided to serve the purposes of the ISFDB. These pages belong to the project, and not to any particular user. Except to deal with violations of those principles stated above or by request of the user, editors should be cautious about editing the user page associated with another user. Such edits are quite unusual. Any disputes about such edits can be brought before the community in a public forum, such as the Community Portal.

User talk page

The user talk page is used to communicate with the user who logs in under a particular UserID. It is the page named "User talk:<UserID>" where <UserID> represents the userID in question. For example, User talk:DESiegel60 is the User talk page for the userID "DESiegel60".

You can leave a new message for a user by creating a new section at the end of his or her user talk page and entering the message there. This can be done by clicking the "+" tab at the top of a user talk page (If using the default monobook skin.)

Many users have particular instructions or requests for messages on their talk pages at the top of such pages. Please read and follow such requests.

When you have read a message on your user talk page, you should usually respond to it in order to let others know that you have read it. Your response will usually indicate what action, if any, you have taken or intend to take on the subject.

Even though we speak of "his talk page" or "Joe's talk page", keep in mind that all Wiki pages, including all user talk pages, are provided to serve the purposes of the ISFDB. They belong to the project as opposed to any particular user and may be freely edited by all editors if there is a good reason.

General discussion conventions

These apply both on user talk pages and on general discussion pages such as the Help desk, the Community Portal, the Rules and standards discussions page, and the Moderator noticeboard.

• The common convention on the ISFDB wiki is that discussion threads are answered where they are started, so that discussions stay together. Thus if you leave a message on a user's talk page (or on one of the public discussion pages) you should check back on that page to see any responses. This is contrary to the default practice on Wikipedia, but it works well on the ISFDB wiki. (Occasionally discussion threads are moved, see #Splitting or moving a discussion, below.)

• The common convention on the ISFDB wiki is that in discussion threads, responses are indented using leading colons to show different levels of response. When a discussion has gotten overly indented, someone may set the indent level back to zero, and prefix that comment with "(unindent)".

• There is some attempt to keep discussions on topic, but they do wander. Sometimes an editor will split a discussion off into a new section or sub-section to try to keep the wandering from hindering discussion.

• Discussions are generally not erased, either from user talk pages or from general discussion pages. However, they are archived. Many such pages have associated archives where older discussions can be seen. Archives should generally not be edited except to fix their format.

• It is generally impolite to edit someone else's comments on a discussion page, except when fixing formatting (e.g. broken wiki-code), moving comments to split threads, and fixing obvious typos and spelling errors.

• Changing one's own comments (beyond fixing typos, spelling errors, wiki code, and other formatting) should be done only within a fairly short time after they are first posted. If much time has gone by, and you have changed your mind, then strike out your previous comments, and add new ones [in brackets], or in some other way that marks them as new, and date the change. This will ensure that the context of other editors' replies is preserved.

• It should be obvious, but: Politeness should be shown at all times in discussion on the ISFDB wiki. In particular, personal attacks on other editors are not acceptable -- see ISFDB:Policy#Blocking_Policy.

• The sole goal of this wiki is to work on and improve the ISFDB -- anything that does not assist that goal is marginal, and anything that impedes it significantly is inappropriate.

• Moderators, who are apt to also be the more experienced editors, are often among the more active editors on discussion pages. However, their opinions do not count any more than those of anyone else -- there are no second class editors here.

One exception: on some policy matters User:Alvonruff, who founded the ISFDB, wrote the initial code, and owns the ISFDB domain, acts as a benevolent dictator, and in his absence, User:Ahasuerus very occasionally acts as his deputy or viceroy. This would include policy changes that aren't technically possible to implement in software, as well as policies involving excessive legal risk.

Editing Help pages

In general, no one should significantly change the Help pages that describe the rules, guidelines, and common practices for making and changing entries in the ISFDB database without first discussing the change on the the Rules and standards discussions page, the Community Portal, the help page's own talk page (provided that an announcement of the discussion is made on a general public forum), or another appropriate public discussion page, and getting a consensus in support of the change.

A similar restraint should often apply before changing a widely used template where that change will affect many pages. If in doubt, discuss first.

Edit Summaries

Please include a short but descriptive edit summary for each wiki edit. When editing a section of a wiki page the edit summary field defaults to "/* Section Name */". You should append your edit summary to this. These summaries help identify the edit and let other users know what is going on. They are shown in the recent changes and page history displays, and in other places.

"Minor" edits

When a wiki page is being edited, there is a checkbox at the bottom of the edit for labeled "This is a minor edit". If that box is checked when the edit is saved, the edit is designated as "minor". A bold-faced m appears next to the edit summary in the recent changes and page history displays, and in other places.

The "minor" flag should be set for changes that do not affect the substance of a page, such as corrections of grammar, spelling, or typing errors, or of wiki markup or other formatting. It is also a good idea to set it for repetitiveness, more or less mechanical, non-controversial changes to a number of related pages, such as the addition of a category or a standard header or footer. This is because other users can opt to hide minor changes on the recent changes page, which prevents changes of greater interest from being hidden or pushed off the page by a series of housekeeping changes.

Any change which is at all likely to be controversial, or which changes the substance of a policy, help, or discussion page, should not be marked as minor. (Note: Archiving a discussion page is not considered to change its substance, and may be marked as minor.)

See Help:Minor edit for more details.

Splitting or moving a discussion

When a discussions wanders from its original topic (as often happens) or a distinct sub-topic emerges within a broader discussion, it may be desirable to split a discussion. In such a case an editor can insert a new section or sub-section header. A new section at the same level as the preexisting section is most often used when the discussion has drifted to a separate topic worth a thread of its own, while a sub-section (section header of a lower level) is most often used when a specific sub-topic of the thread topic has emerged. Whether and how to split a discussion is a judgment call.

When a discussion becomes more appropriate for a different page, it may be copied or moved. For example, Suppose a discussion about the fats of a particular publication starts with a query to an editor who has verified that pub on the verifier's talk page. This may then drift into a more general discussion about what the standards for recording such a pub should be. If this goes on for a while, and particularly if it starts to approach serious consideration of policy changes, it may be a good idea to move ort copy it to a public discussion forum, such as the Rules and standards discussions page.

In such a case, someone edits the page, and copies the relevant wiki text, pasting it into a new section on the destination page. Indents may need to be adjusted. If a move is intended, the wiki text is deleted from the source page, and that is saved.

Whenever a thread is split, or a thread is copied or moved, an explanatory note using the "small" tag should be added to both source and destination, so that readers of the later discussion can find the original context and history, and readers of the original can find the ongoing discussion. Such notes should be signed by the editor who splits, moves, or copes the discussion. (For example: "<small>Further discussion moved to [[Rules and standards discussions#How to enter a plagiarized story]] ~~~~</small>".)