Diff for "WikiConventions"

Not logged in - Log In / Register

Differences between revisions 1 and 2
Revision 1 as of 2009-08-03 22:39:37
Size: 1674
Editor: kfogel
Comment: New page.
Revision 2 as of 2009-08-03 22:46:44
Size: 1680
Editor: kfogel
Comment: Wording tweak.
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
||<tablestyle="width: 100%;" colspan=3 style="background: #2a2929; font-weight: bold; color: #f6bc05;">This page tells you our conventions for maintaining this wiki. Please [[Help|ask for help]] if you have any questions. || ||<tablestyle="width: 100%;" colspan=3 style="background: #2a2929; font-weight: bold; color: #f6bc05;">This page tells you the conventions we use in maintaining this wiki. Please [[Help|ask for help]] if you have any questions. ||

This page tells you the conventions we use in maintaining this wiki. Please ask for help if you have any questions.

Most of the conventions in this wiki are self-explanatory. If you see something wrong, please just fix it (or if you're not sure, ask for help and then fix it).

Summary Bar

Most pages have a horizontal, black-background summary bar near the top, stating briefly what that page will tell the user. This is so readers can know quickly whether or not they've landed in the right place. (See Getting or Running, for example). A summary bar looks like this:

This page tells you how to frobnicate Launchpad's flux capacitors. Ask for help right away if you have any questions.

The summary bar should always end with a sentence encouraging the reader to ask for help whenever they need it, linking to the Help page.

Please put a summary bar on any new pages you start. If you see existing pages that don't have the bar, fix them. (You can just copy-and-paste from one of the pages that does have it.)

Distinguish Between Explanatory Pages and Reference Pages

When a page explains a topic from the top down, don't try to pack too much information onto it; instead, farm out to sub-pages for details. But when a page is a reference page, it's okay to make it big, because the expectation is that the reader will search within the page rather than browse it from the beginning.

WikiConventions (last edited 2010-04-27 00:15:29 by adiroiban)