Help:Handbook guidelines
From The Scuba Wiki
Revision as of 09:07, 23 November 2009
| MediaWiki Handbook: Contents, Readers, Editors, Moderators, System admins +/- |
This is a page for technical aspects in creating a handbook. It is different from the Help:MediaWiki help policy stuff because this is about the templates and the technical issues in formatting handbooks.
Contents |
Vision
The intention is that the master page of any help page in a given language is on Meta, and that this can be copied without modification (hence very easily, either manually or automatically) into another wiki of the same language.
Categories
for admin handbook, sys-op handbook, reader handbook.. any page that has information for said group should be in that category
Sidebars
The index page embeds a template into it, so it appears to be a normal page, the smaller lists of features are appropriate as sidebars.
Audience Factors
- Field Experience -- more experienced users know what to search for
- Site Experience -- more experienced users know how the wiki is laid out
- Sys Admin -- these people are running their own server
- Hacker -- these people are probably sys admins, and they are digging into the code
- Moderator/Sys-op -- these people have been granted special access to the website, and need to know how to delete pages and do other privileged stuff
- Reader -- these people are searching for information
- Editor -- these people are contributing content to the project
- Time Constraints -- An audience member may not have time to look up why a choice was made, or just need to know how to solve an immediate problem.
- Viewing Equipment -- Someone may need to print the content, in which long sequential guides are important...
- Language --
- Learning Style --
- Problem at Hand --
Content
The commands used in the instructions given to people will remain the same, regardless of the language of the audience. Therefore the commands should make the skeleton of a page, and the language dependant content should be added as the meat of the content. -- but this comes later! we still need to content! in english even!
We Shouldn't strive for full Xanadu project functionality, because that is an extremely complex issue, however we can selectively use transclusion when it makes sense.
Some instructions are common across procedures, and if the commands change globally, then it makes sense to have the instructions in a template.
This list of templates used on help pages, but not yet covered by the handbook, is not complete. Please add what you find, or try to remove what's not really needed worldwide:
- template:- ( talk edit history links ) (available at least on w:en:)
- template:Evaldemo ( talk edit history links ) (available at least on w:en:)
- template:Evd ( talk edit history links ) (available at least on w:en:)
- template:Evdn ( talk edit history links ) (available at least on w:en:)
- template:H:mwg ( talk edit history links ) (available at least on w:en:)
- template:Hh ( talk edit history links ) ("copy from Meta" blurb on w:en:)
- template:Ill ( talk edit history links ) (unnecessary on w:en)
- template:MediaWiki links ( talk edit history links ) (intentionally different on w:en)
- template:Tim ( talk edit history links ) (available at least on w:en:)
- template:Tiw ( talk edit history links ) (again available on w:en:)
- template:Tl ( talk edit history links ) (available at least on w:en:)
- template:Unclear ( talk edit history links ) (available at least on w:en:)
- Category:Handbook templates is a collection of templates used on help pages.
- Help:MediaWiki help policy explains some of these templates
- Help:Help page footer templates tackles H:f and H-langs templates
Links to other help pages
- Help contents
- Meta | Wikinews | Wikipedia | Wikiquote | Wiktionary | commons: | mw: | b: | s: | mw:Manual | google
- Versions of this help page (for other languages see below)
- Meta | Wikinews | Wikipedia | Wikiquote | Wiktionary
- What links here on Meta or from Meta | Wikipedia | MediaWiki
- Reading
- Go | Search | Stop words | URL | Namespace | Page name | Section
- Backlinks | Link | Piped link | Interwiki link | Redirect | Category | Image page
- Logging in and preferences
- Logging in | Preferences | User style
- Editing
- Advanced editing | Editing FAQ | Edit toolbar | Export | Import | Shortcuts
- Tracking changes
- Recent changes (enhanced) | Related changes | Watching pages | Diff
- Page history | Edit summary | User contributions | Minor edit | Patrolled edit
- Style & formatting
- Wikitext examples | Reference card | HTML in wikitext | List | Table | Sorting | Colors
- Special input and output
- Inputbox | Special characters | Displaying a formula | Images (uploads) | EasyTimeline
- Advanced functioning
- Template | Advanced templates | Parser function | ParserFunctions | Parameter default
- Variable | Magic word | System message | Substitution | Array | Calculation
- Page management
- Starting a new page | Renaming (moving) a page | Protecting pages | Deleting a page
- Special pages
- Talk page | Testing | Sandbox | CentralNotice
