Documentation/Maemo Documentation Guidelines/Introduction - Revision history

amigadave: wikify image formatting

2010-11-10T13:07:48Z

wikify image formatting

← Older revision		Revision as of 13:07, 10 November 2010
Line 1:		Line 1:
-	''Maemo Documentation Guidelines'' is meant for Maemo documentation purposes only. This guide presents the general guidelines to be followed when writing and editing technical documentation for all Maemo platform and Maemo device releases, figure [[#~~fig:~~documentation_guidelines-introduction-n900\|1.1]].	+	''Maemo Documentation Guidelines'' is meant for Maemo documentation purposes only. This guide presents the general guidelines to be followed when writing and editing technical documentation for all Maemo platform and Maemo device releases, figure [[#figure-documentation_guidelines-introduction-n900\|1.1]].

-	~~{\| summary~~="~~Maemo device~~ - ~~N900~~"	+	<div id="figure-documentation_guidelines-introduction-n900">
-	\|~~+ align~~=~~"BOTTOM"~~ \|~~'''~~Figure 1.1:~~'''~~ Maemo device - ~~N900~~	+	[[Image:Nokia N900 48.png\|frame\|center\|alt=Photo of N900 with extended hardware keyboard\|Figure 1.1: Maemo device - [[Nokia N900\|N900]]]]
-	\|-	+	</div>
-	\|	+
-	[[~~Image:~~Nokia N900 ~~48.png~~\|~~Image Nokia_N900_20~~]]	+
-	\|}	+

	''Maemo Documentation Guidelines'' provides editorial guidelines for content published by Maemo electronically or in print, including white papers, case studies and success stories, tutorials, technical documentation, news stories, Web pages, Web teasers and blurbs, and marketing material such as developer catalogues and brochures.		''Maemo Documentation Guidelines'' provides editorial guidelines for content published by Maemo electronically or in print, including white papers, case studies and success stories, tutorials, technical documentation, news stories, Web pages, Web teasers and blurbs, and marketing material such as developer catalogues and brochures.

amigadave: wikify slightly

2010-07-15T07:40:59Z

wikify slightly

← Older revision		Revision as of 07:40, 15 July 2010
Line 1:		Line 1:
-	~~= Introduction =~~
-
	''Maemo Documentation Guidelines'' is meant for Maemo documentation purposes only. This guide presents the general guidelines to be followed when writing and editing technical documentation for all Maemo platform and Maemo device releases, figure [[#fig:documentation_guidelines-introduction-n900\|1.1]].		''Maemo Documentation Guidelines'' is meant for Maemo documentation purposes only. This guide presents the general guidelines to be followed when writing and editing technical documentation for all Maemo platform and Maemo device releases, figure [[#fig:documentation_guidelines-introduction-n900\|1.1]].
-
-

	{\| summary="Maemo device - N900"		{\| summary="Maemo device - N900"
Line 9:		Line 5:
	\|-		\|-
	\|		\|
-	[[Image:~~Nokia_N900_20~~.png\|Image Nokia_N900_20]]	+	[[Image:Nokia N900 48.png\|Image Nokia_N900_20]]
	\|}		\|}
-
-

	''Maemo Documentation Guidelines'' provides editorial guidelines for content published by Maemo electronically or in print, including white papers, case studies and success stories, tutorials, technical documentation, news stories, Web pages, Web teasers and blurbs, and marketing material such as developer catalogues and brochures.		''Maemo Documentation Guidelines'' provides editorial guidelines for content published by Maemo electronically or in print, including white papers, case studies and success stories, tutorials, technical documentation, news stories, Web pages, Web teasers and blurbs, and marketing material such as developer catalogues and brochures.
Line 26:		Line 20:
	Certain points made in the reference materials above are repeated in this document for emphasis. With newly created content, follow the guidelines. When working on older, existing content, incorporate as many of the guidelines as possible, while maintaining consistency within each document or other unit of content.		Certain points made in the reference materials above are repeated in this document for emphasis. With newly created content, follow the guidelines. When working on older, existing content, incorporate as many of the guidelines as possible, while maintaining consistency within each document or other unit of content.

-	Also note that ''The Elements of Style'' <ref name=r3>The Elements of Style. ~~http://en.wikipedia.org/wiki/The_Elements_of_Style~~</ref> provides excellent general guidance on language usage, composition, and style, and that ''The Associated Press Stylebook'' <ref name=r1>The Associated Press Stylebook. http://www.apstylebook.com/</ref> is useful for issues of journalistic type, such as geographic references, that may come up in newsletters and the like.	+	Also note that ''The Elements of Style'' <ref name=r3>[[:wikipedia:The Elements of Style\|The Elements of Style]].</ref> provides excellent general guidance on language usage, composition, and style, and that ''The Associated Press Stylebook'' <ref name=r1>The Associated Press Stylebook. http://www.apstylebook.com/</ref> is useful for issues of journalistic type, such as geographic references, that may come up in newsletters and the like.

	Using this document by searching through it electronically is highly recommended. This guide largely follows the editorial style it recommends and can therefore in general be used as a style model. The comment do not use means precisely that; avoid means do not use except when nothing else will do.		Using this document by searching through it electronically is highly recommended. This guide largely follows the editorial style it recommends and can therefore in general be used as a style model. The comment do not use means precisely that; avoid means do not use except when nothing else will do.

-	Feedback about this guide is always welcome. In addition, before each version of the guide is distributed generally, a draft is sent out for review. Feedback or style queries should be directed to ~~<span><font face="monospace">~~documentation@maemo.org~~</font></span>~~. Updated versions of this guide are released periodically.	+	Feedback about this guide is always welcome. In addition, before each version of the guide is distributed generally, a draft is sent out for review. Feedback or style queries should be directed to [mailto:documentation@maemo.org documentation@maemo.org]. Updated versions of this guide are released periodically.

		+	== References ==

-
-	~~----~~
-	~~== References ==~~
	<references />		<references />

	[[Category:Documentation]]		[[Category:Documentation]]

amigadave: categorize

2010-05-10T11:57:34Z

categorize

← Older revision		Revision as of 11:57, 10 May 2010
Line 37:		Line 37:
	== References ==		== References ==
	<references />		<references />
		+
		+	[[Category:Documentation]]

dneary: 1 revision

2010-04-09T13:34:56Z

1 revision

← Older revision

Revision as of 13:34, 9 April 2010

Wikiuser: importing documentation, see Meta:Problems in the LaTeX2HTML2Wiki import process

2010-04-09T08:48:11Z

importing documentation, see Meta:Problems in the LaTeX2HTML2Wiki import process

New page

= Introduction =

''Maemo Documentation Guidelines'' is meant for Maemo documentation purposes only. This guide presents the general guidelines to be followed when writing and editing technical documentation for all Maemo platform and Maemo device releases, figure [[#fig:documentation_guidelines-introduction-n900|1.1]].

{| summary="Maemo device - N900"
|+ align="BOTTOM" |'''Figure 1.1:''' Maemo device - N900
|-
|
[[Image:Nokia_N900_20.png|Image Nokia_N900_20]]
|}

''Maemo Documentation Guidelines'' provides editorial guidelines for content published by Maemo electronically or in print, including white papers, case studies and success stories, tutorials, technical documentation, news stories, Web pages, Web teasers and blurbs, and marketing material such as developer catalogues and brochures.

The following resources supplement this document:

* ''Nokia A-Z Marketing Language Guide'' <ref name=r5>Nokia A-Z Marketing Language Guide. http://brandbook.nokia.com</ref> at [http://brandbook.nokia.com/ Nokia Brand Book] site (not publically available).
* ''Nokia Brand Book'' <ref name=r6>Nokia Brand Book. http://brandbook.nokia.com</ref> at [http://brandbook.nokia.com/ Nokia Brand Book] site (not publically available).
* ''Collins English Dictionary'' <ref name=r2>Collins English Dictionary. http://www.collinslanguage.com</ref> at [http://www.collinslanguage.com/ Collins Language] site.

In cases where guidelines in two or more resources conflict, the ones in Maemo Documentation Guidelines document take precedence, followed by the documents above in the order listed with the exception of spelling concerns. To resolve spelling concerns for words or terms, first consult the ''Collins English Dictionary''.

Certain points made in the reference materials above are repeated in this document for emphasis. With newly created content, follow the guidelines. When working on older, existing content, incorporate as many of the guidelines as possible, while maintaining consistency within each document or other unit of content.

Also note that ''The Elements of Style'' <ref name=r3>The Elements of Style. http://en.wikipedia.org/wiki/The_Elements_of_Style</ref> provides excellent general guidance on language usage, composition, and style, and that ''The Associated Press Stylebook'' <ref name=r1>The Associated Press Stylebook. http://www.apstylebook.com/</ref> is useful for issues of journalistic type, such as geographic references, that may come up in newsletters and the like.

Using this document by searching through it electronically is highly recommended. This guide largely follows the editorial style it recommends and can therefore in general be used as a style model. The comment do not use means precisely that; avoid means do not use except when nothing else will do.

Feedback about this guide is always welcome. In addition, before each version of the guide is distributed generally, a draft is sent out for review. Feedback or style queries should be directed to <span><font face="monospace">documentation@maemo.org</font></span>. Updated versions of this guide are released periodically.

----
== References ==
<references />