Difference between revisions of "User:Jaszon Maynard/Jaszons sandbox Help the general help"
(editing) |
(editing) |
||
| Line 1: | Line 1: | ||
<big>'''I'm currently developing this article and will probably eventually publish it to the wiki'''</big> | <big>'''I'm currently developing this article and will probably eventually publish it to the wiki'''</big> | ||
There's a lot to write for this Help, here's a few thoughts and tips about that | There's a lot to write for this Help, here's a few thoughts and tips about that. | ||
== Articles That Need Work == | == Articles That Need Work == | ||
| Line 9: | Line 9: | ||
== Issues Regarding Writing Articles == | == Issues Regarding Writing Articles == | ||
=== Organization of Topics === | |||
It seems likely that eventually a lot of the information contained under [[Main Viewer]] will be accessible from two perspectives: 1) From a mechanical perspective, the perspective of the menus and dialogs in the [[Viewer]]; and 2) From a functional perspective. And this is probably a good thing. | |||
=== Write Or Link? === | |||
KB | KB | ||
refer to linked official area, only talk about what not covered there | refer to linked official area, only talk about what not covered there | ||
linking to KB also slow! & freq tech problems login | linking to KB also slow! & freq tech problems login | ||
=== Operating System Independence === | === Operating System Independence === | ||
| Line 20: | Line 25: | ||
When starting an article it may help future editors if you give some thought to structure and platform-specific dependencies: Can the article be written as a single topic that's valid for all operating systems (with perhaps small embedded notes about O.S. differences), or does the article need to have major sub-sections where section 1 deals just with Windows, section 2 Macintosh, and section 3 Linux? | When starting an article it may help future editors if you give some thought to structure and platform-specific dependencies: Can the article be written as a single topic that's valid for all operating systems (with perhaps small embedded notes about O.S. differences), or does the article need to have major sub-sections where section 1 deals just with Windows, section 2 Macintosh, and section 3 Linux? | ||
=== SLurls | === SLurls, Tutorials === | ||
When possible the article should include useful SLurls, and if there are applicable in-world tutorials definitely give a [[SLURL|SLurl]] to the relevant place (like Public Orientation Island or Public Help Island). Since the [[SLURL|SLurl]] won't bring you right to the tutorial, & the islands can be crowded, confusing, laggy, & crashy, describe major landmarks near the applicable tutorial and how to get there so the resident can find it. i.e.--<i>Once you've arrived, find the tall building labelled "XYZ". Stand so the building is to your left. Walk straight ahead until you come to a stand of trees, and look for a sign on your right....</i> | When possible the article should include useful [[SLURL|SLurls]], and if there are applicable in-world tutorials definitely give a [[SLURL|SLurl]] to the relevant place (like Public Orientation Island or Public Help Island). Since the [[SLURL|SLurl]] won't bring you right to the tutorial, & the islands can be crowded, confusing, laggy, & crashy, describe major landmarks near the applicable tutorial and how to get there so the resident can find it. i.e.--<i>Once you've arrived, find the tall building labelled "XYZ". Stand so the building is to your left. Walk straight ahead until you come to a stand of trees, and look for a sign on your right....</i> | ||
Revision as of 22:36, 25 February 2008
I'm currently developing this article and will probably eventually publish it to the wiki
There's a lot to write for this Help, here's a few thoughts and tips about that.
Articles That Need Work
In addition to the various red links you will find to articles that need to be created, here's a list of articles that need expansion or that have barely been written at all: Help stubs.
Issues Regarding Writing Articles
Organization of Topics
It seems likely that eventually a lot of the information contained under Main Viewer will be accessible from two perspectives: 1) From a mechanical perspective, the perspective of the menus and dialogs in the Viewer; and 2) From a functional perspective. And this is probably a good thing.
Write Or Link?
KB refer to linked official area, only talk about what not covered there linking to KB also slow! & freq tech problems login
Operating System Independence
When starting an article it may help future editors if you give some thought to structure and platform-specific dependencies: Can the article be written as a single topic that's valid for all operating systems (with perhaps small embedded notes about O.S. differences), or does the article need to have major sub-sections where section 1 deals just with Windows, section 2 Macintosh, and section 3 Linux?
SLurls, Tutorials
When possible the article should include useful SLurls, and if there are applicable in-world tutorials definitely give a SLurl to the relevant place (like Public Orientation Island or Public Help Island). Since the SLurl won't bring you right to the tutorial, & the islands can be crowded, confusing, laggy, & crashy, describe major landmarks near the applicable tutorial and how to get there so the resident can find it. i.e.--Once you've arrived, find the tall building labelled "XYZ". Stand so the building is to your left. Walk straight ahead until you come to a stand of trees, and look for a sign on your right....