Wiki Construction Notes: Difference between revisions
No edit summary |
|||
| Line 14: | Line 14: | ||
---- | ---- | ||
===Sources of information=== | ===Sources of information=== | ||
If you are in search of information about writing in a wiki, [[http://meta.wikimedia.org/wiki/Help:Editing Help]] is the best we've found, so far. Many find this [[http://meta.wikimedia.org/wiki/Help:Advanced_editing Formatting]] a very useful information source for layout details. | If you are in search of information about writing in a wiki, [[http://meta.wikimedia.org/wiki/Help:Editing Help]] is the best we've found, so far. Many find this [[http://meta.wikimedia.org/wiki/Help:Advanced_editing Formatting]] a very useful information source for layout details.<br> | ||
Graphics (or images in wiki-speak) seem genuinely difficult to manipulate. The best source seems to be [http://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax Images]. | |||
---- | ---- | ||
Revision as of 08:03, 27 October 2006
Everyone is welcome to contribute to this wiki.
"
Remember our motto: "Everything is difficult the first time you do it."
This implies that at first, the wki should concentrate on helping first-time and beginning users; help for experts comes later.
A second objective is to get this as complete as possible for HFS 2.1
You are not prohibited from writing about older versions (although it's difficult to see why anyone would want to), but you should make it very clear exactly which version you are writing about.
Incidentally, if anyone wonders about what's normally called the "Documentation Problem" --- MicroSoft employ around 75 full-time professional writers permanently devoted to the Help and user-documentation for Word. As their development cycle nears it's end, this number rises to over 300.
Fortunately, HFS doesn't raise such demands, and anyway, the codes probably better written too.
Sources of information
If you are in search of information about writing in a wiki, [Help] is the best we've found, so far. Many find this [Formatting] a very useful information source for layout details.
Graphics (or images in wiki-speak) seem genuinely difficult to manipulate. The best source seems to be Images.
Sandbox
The above sources suggest that "If you want to try out things without danger of doing any harm, you can do so in the Meta:Sandbox".
However, we'd far rather you used your personal sandbox. You can find this under "Personal tools" in the tool bar on the right of the screen. It matches your wiki username.
Editing policy
We'd also like to remind you that, under the terms of the Project Copyright Licence, "If you don't want your writing to be edited mercilessly and redistributed at will, then don't submit it here."
Markers
Throughout this wiki you'll see mysterious PHnote markers. These simply indicate to a contributor, whose initials happen to be PH, that something here needs to be fixed. You're welcome to adopt the same technique, but please use your own initials so that we can contact you in case of difficulty.
Menus
Wrong way to do menus
Set Upload → upload for accounts → anyone
Write! way (matches software, uses italic font, and no spaces)
Set Upload→Upload for accounts→Anyone
Graphic handling
We haven't yet worked out the best way to handle screen dumps and other pictures. These are just experiments right now.
Click to enlarge
| Style notes | English usage guidelines. |
| Graphic experiment | Yet another sandbox. |