Openmoko Wiki Editing Guidelines
From Openmoko
m (Correct last edit.) |
PaulBoddie (Talk | contribs) m (Minor wording, naming, tidying changes.) |
||
Line 4: | Line 4: | ||
== Naming == | == Naming == | ||
− | # Openmoko | + | # Openmoko refers only to the software (think Openmoko GNU/Linux distribution), not to any of the devices |
# Neo 1973 is the first hardware device that officially runs Openmoko | # Neo 1973 is the first hardware device that officially runs Openmoko | ||
# Use "the smartphone" if you refer to a hardware device that could be Neo 1973 but could also be a later version | # Use "the smartphone" if you refer to a hardware device that could be Neo 1973 but could also be a later version | ||
Line 10: | Line 10: | ||
== Rules == | == Rules == | ||
− | # If you're adding information ( | + | # If you're adding information (especially pages) about the hardware, keep in mind that the Neo 1973 is only one of the various devices that will run Openmoko. Thus, |
− | ## Do not create generic pages like "Battery", rather use "Neo 1973 Battery" | + | ## Do not create generic pages like "Battery", rather use "Neo 1973 Battery". |
− | ## If it makes sense to have generic pages, use per-device sections and make sure you always link to the Neo 1973 section from other Neo 1973 specific pages | + | ## If it makes sense to have generic pages, use per-device sections and make sure you always link to the Neo 1973 section from other Neo 1973 specific pages. |
− | ## See [http://wiki.openmoko.org/wiki/Help:Contents#A_list_of_definitive_spellings_used_throughout_the_site | + | ## See [http://wiki.openmoko.org/wiki/Help:Contents#A_list_of_definitive_spellings_used_throughout_the_site this] page for a list of other definitive spellings used in the Openmoko project. |
# The wiki is primarily meant to contain factual information on actual project software, hardware, even though parts might still be under development. Thus, | # The wiki is primarily meant to contain factual information on actual project software, hardware, even though parts might still be under development. Thus, | ||
− | ## If you're adding information about wishlist items (or even more imaginary things), please clearly mark them with a "Wishlist:" prefix in the page title. | + | ## If you're adding information about wishlist items (or even more imaginary things), please clearly mark them with a "Wishlist:" prefix in the page title. |
## Always make sure that an outside user can clearly distinguish between the actual feature set of the device, and "interesting theoretical plans of what one could do if he had time" :) | ## Always make sure that an outside user can clearly distinguish between the actual feature set of the device, and "interesting theoretical plans of what one could do if he had time" :) | ||
Line 39: | Line 39: | ||
* If a page truly fits in multiple categories, OK, but the wiki will be more organized if you pick the one most-accurate category. | * If a page truly fits in multiple categories, OK, but the wiki will be more organized if you pick the one most-accurate category. | ||
* Review the existing category hierarchy on the [[:Category:Categories]] page. (Be sure to press the + buttons to see the subcategories.) | * Review the existing category hierarchy on the [[:Category:Categories]] page. (Be sure to press the + buttons to see the subcategories.) | ||
− | * A complete flat list of categories is available on the special [[Special:Categories | categories]] page. | + | * A complete flat list of categories is available on the special [[Special:Categories|categories]] page. |
* If a category does not exist and you think a new one is required then use the same category syntax to create a new one. | * If a category does not exist and you think a new one is required then use the same category syntax to create a new one. | ||
Line 62: | Line 62: | ||
* Numbers [0-9] | * Numbers [0-9] | ||
** 1973 | ** 1973 | ||
− | ***(the model name of the first | + | ***(the model name of the first Openmoko phone) |
*A | *A | ||
Line 76: | Line 76: | ||
** FreeRunner | ** FreeRunner | ||
***(not freerunner or Freerunner) | ***(not freerunner or Freerunner) | ||
− | ***(the model name of the 2nd | + | ***(the model name of the 2nd Openmoko phone) |
*G | *G | ||
Line 94: | Line 94: | ||
*N | *N | ||
** Neo | ** Neo | ||
− | *** (the brand name of | + | *** (the brand name of Openmoko phones) |
** Neo 1973 | ** Neo 1973 | ||
− | *** (the brand and model name of the first | + | *** (the brand and model name of the first Openmoko phone) |
− | *** (not neo1973 or neo 1973. Note this has changed during the course of the project and a lot of current entries in the Wiki and software are wrong. See | + | *** (not neo1973 or neo 1973. Note this has changed during the course of the project and a lot of current entries in the Wiki and software are wrong. See [http://lists.openmoko.org/pipermail/community/2008-February/013136.html here] for the official pronouncement as of February 2008) |
** Neo FreeRunner | ** Neo FreeRunner | ||
− | *** (the brand and model name of the second | + | *** (the brand and model name of the second Openmoko phone) |
*** (not NeoFreeRunner or neo freerunner) | *** (not NeoFreeRunner or neo freerunner) | ||
Line 105: | Line 105: | ||
** Openmoko | ** Openmoko | ||
*** (the name of the complete software stack) | *** (the name of the complete software stack) | ||
− | *** (not "OpenMoko" anymore as of [http://www.businesswire.com/portal/site/home/?newsLang=en&viewID=news_view_popup&epi-content=NEWS_VIEW_POPUP_TYPE&beanStrID=reportcenterndm&newsId=20080304005158 | + | *** (not "OpenMoko" anymore as of [http://www.businesswire.com/portal/site/home/?newsLang=en&viewID=news_view_popup&epi-content=NEWS_VIEW_POPUP_TYPE&beanStrID=reportcenterndm&newsId=20080304005158 March 2008]. Note this change means many current entries in the wiki are wrong - please help to amend!) |
** Openmoko Inc | ** Openmoko Inc | ||
*** (the name of the Taiwanese company that develops products for the project) | *** (the name of the Taiwanese company that develops products for the project) | ||
Line 142: | Line 142: | ||
[[Category:Help]] | [[Category:Help]] | ||
− | [[Category:Information | + | [[Category:Information]] |
Revision as of 13:34, 1 August 2008
Our Openmoko Wiki Editing Guidelines are meant to assist our users in editing this wiki. They try to ensure a somewhat more consistent and organized structure.
Contents |
Naming
- Openmoko refers only to the software (think Openmoko GNU/Linux distribution), not to any of the devices
- Neo 1973 is the first hardware device that officially runs Openmoko
- Use "the smartphone" if you refer to a hardware device that could be Neo 1973 but could also be a later version
Rules
- If you're adding information (especially pages) about the hardware, keep in mind that the Neo 1973 is only one of the various devices that will run Openmoko. Thus,
- Do not create generic pages like "Battery", rather use "Neo 1973 Battery".
- If it makes sense to have generic pages, use per-device sections and make sure you always link to the Neo 1973 section from other Neo 1973 specific pages.
- See this page for a list of other definitive spellings used in the Openmoko project.
- The wiki is primarily meant to contain factual information on actual project software, hardware, even though parts might still be under development. Thus,
- If you're adding information about wishlist items (or even more imaginary things), please clearly mark them with a "Wishlist:" prefix in the page title.
- Always make sure that an outside user can clearly distinguish between the actual feature set of the device, and "interesting theoretical plans of what one could do if he had time" :)
Adding a new page
To start a new page you can either create a link to it first on another page, like this:
[[My new page]]
then click the resulting link and start editing the new page, or you can add your new page name to the URL in your browser's address-bar, like this:
http://wiki.openmoko.org/wiki/My_new_page
and create the page first, before linking to it, or allow the wiki nannies to do the linking for you... they will see your page show up here:
http://wiki.openmoko.org/wiki/Special:Recentchanges
Use categories
Adding categories to a page allows the wiki engine to organize the content automagically. This allows readers to find information in an organized way.
- Please add a category at the bottom of the pages you create, trying to select the one most-accurate category for the page.
- If a page truly fits in multiple categories, OK, but the wiki will be more organized if you pick the one most-accurate category.
- Review the existing category hierarchy on the Category:Categories page. (Be sure to press the + buttons to see the subcategories.)
- A complete flat list of categories is available on the special categories page.
- If a category does not exist and you think a new one is required then use the same category syntax to create a new one.
To add your page to a category:
[[Category:My selected category]] [[Category:My new category]]
If you are creating a new category, then be sure to click on the new category link and define what you were thinking should go into this category. Please be brief so readers will easily see the automatically indexed page links below your introduction text.
To link to a category page within the page text:
[[:Category:My new category | My new category]]
For more help on categories, please see MediaWiki's "Categories" help page.
Style Sheet
A list of definitive spellings used throughout the site
- Numbers [0-9]
- 1973
- (the model name of the first Openmoko phone)
- 1973
- A
- B
- C
- D
- E
- F
- FreeRunner
- (not freerunner or Freerunner)
- (the model name of the 2nd Openmoko phone)
- FreeRunner
- G
- H
- I
- J
- K
- L
- M
- MokoMakefile (and it's not a script)
- N
- Neo
- (the brand name of Openmoko phones)
- Neo 1973
- (the brand and model name of the first Openmoko phone)
- (not neo1973 or neo 1973. Note this has changed during the course of the project and a lot of current entries in the Wiki and software are wrong. See here for the official pronouncement as of February 2008)
- Neo FreeRunner
- (the brand and model name of the second Openmoko phone)
- (not NeoFreeRunner or neo freerunner)
- Neo
- O
- Openmoko
- (the name of the complete software stack)
- (not "OpenMoko" anymore as of March 2008. Note this change means many current entries in the wiki are wrong - please help to amend!)
- Openmoko Inc
- (the name of the Taiwanese company that develops products for the project)
- openmoko.org
- (the community, non-commercial website for the project)
- openmoko.com
- (the commercial website and webshop of Openmoko Inc)
- Openmoko
- P
- Q
- R
- S
- T
- U
- V
- W
- X
- Y
- Z
Follow your own pages
When you create a new page, it's a good idea to add it to your watchlist. Check your watchlist regularly to keep up with the evolution of the pages you have created, help the new editors of your page.
![]() |
Languages: |
English • العربية • Български • Česky • Dansk • Deutsch • Esperanto • Eesti • Español • فارسی • Suomi • Français • עברית • Magyar • Italiano • 한국어 • Nederlands • Norsk (bokmål) • Polski • Português • Română • Русский • Svenska • Slovenčina • Українська • 中文(中国大陆) • 中文(台灣) • Euskara • Català |