Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "DocumentationGuidelines"
(→Chapters) |
m (→Chapters) |
||
(24 intermediate revisions by the same user not shown) | |||
Line 7: | Line 7: | ||
This guide will may make reference and where appropriate cite the various sections from these guides. | This guide will may make reference and where appropriate cite the various sections from these guides. | ||
+ | s | ||
+ | {{important |Citations|If referencing another source, or summarizing information, use either hyperlinks or use the [http://www.mediawiki.org/wiki/Extension:Cite/Cite.php Cite mediawiki extension] to document the references.}} | ||
− | + | In addition, portions of the existing [[Eclipse_Doc_Style_Guide]] guidelines have been used and extended. | |
− | =Goals= | + | == Goals == |
− | + | This guideline is here to help the author of Eclipse Documentation use the wiki as their content source. To make sure that there is a consistent look and feel, this guideline will provide guidance on: | |
− | + | * Authoring Resources | |
+ | * Grammar and Writing Style | ||
+ | * Style | ||
+ | * Publishing | ||
− | + | Those wishing to help contribute, are encouraged to do so. | |
− | * [[DocumentationGuidelines/ | + | == Chapters == |
+ | |||
+ | The [[DocumentationGuidelines | DocumentationGuidelines]] are made of of several pages and sub-pages. This section as well as the ''Category:Documentation'' and ''Category:Draft_Documentation'' pages can be used to review the relevant chapters. | ||
+ | |||
+ | * [[DocumentationGuidelines/AuthoringResources | Authoring Resources]] | ||
+ | * [[DocumentationGuidelines/ConvertExistingContent | Options for Converting Existing Content to MediaWiki]] | ||
+ | * [https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/InternationalAudience Writing for an International Audience] | ||
+ | * [http://owl.english.purdue.edu/owl/resource/589/01/ Plagiarism. How to Avoid it.] | ||
+ | * [https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/SpellingPunctuationGrammar Grammar, Punctuation, and Spelling...OH MY!] | ||
+ | * [https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/CommonlyConfusedWords No Excuse Errors.] | ||
+ | * [[DocumentationGuidelines/WikiSingleSourcing | Wiki Single Sourcing]] | ||
* [[DocumentationGuidelines/StyleGuidelines | Style Guidelines]] | * [[DocumentationGuidelines/StyleGuidelines | Style Guidelines]] | ||
* [[DocumentationGuidelines/Publishing | Publishing]] | * [[DocumentationGuidelines/Publishing | Publishing]] | ||
+ | |||
+ | == References == | ||
+ | These resources may be of additional use in helping to craft your project's user documentation. | ||
+ | |||
+ | * [[Eclipse_Doc_Style_Guide | Eclipse Documentation Style Guide]] (note this is geared toward HTML documentation). | ||
+ | * [http://oreilly.com/oreilly/author/stylesheet.html O'Reilly Default Stylesheet and Word List]. | ||
+ | * [http://owl.english.purdue.edu/ Purdue University Online Writing Lab (OWL)]. | ||
+ | * [http://docs.fedoraproject.org//documentation-guide/ Fedora Documentation Project]. | ||
+ | * [https://wiki.ubuntu.com/DocumentationTeam Ubuntu Documentation Team]. | ||
+ | * [http://l10n.kde.org/docs//styleguide/index.html KDE Style Guide]. | ||
+ | * [http://library.gnome.org/devel/gdp-style-guide/stable/ GNOME Style Guide]. | ||
+ | * [http://en.wikipedia.org/wiki/Style_guide Wikipedia Article on Style Guides]. | ||
[[Category:Documentation_Guidelines ]] | [[Category:Documentation_Guidelines ]] | ||
[[Category:Draft_Documentation ]] | [[Category:Draft_Documentation ]] |
Latest revision as of 09:17, 4 November 2010
The Documentation Guidelines maintain a reference to important information when using the Eclipse Wiki for single sourcing eclipse project documentation. The eclipse documentation guidelines are heavily influenced by two very successful open source documentation projects:
This guide will may make reference and where appropriate cite the various sections from these guides. s
In addition, portions of the existing Eclipse_Doc_Style_Guide guidelines have been used and extended.
Goals
This guideline is here to help the author of Eclipse Documentation use the wiki as their content source. To make sure that there is a consistent look and feel, this guideline will provide guidance on:
- Authoring Resources
- Grammar and Writing Style
- Style
- Publishing
Those wishing to help contribute, are encouraged to do so.
Chapters
The DocumentationGuidelines are made of of several pages and sub-pages. This section as well as the Category:Documentation and Category:Draft_Documentation pages can be used to review the relevant chapters.
- Authoring Resources
- Options for Converting Existing Content to MediaWiki
- Writing for an International Audience
- Plagiarism. How to Avoid it.
- Grammar, Punctuation, and Spelling...OH MY!
- No Excuse Errors.
- Wiki Single Sourcing
- Style Guidelines
- Publishing
References
These resources may be of additional use in helping to craft your project's user documentation.
- Eclipse Documentation Style Guide (note this is geared toward HTML documentation).
- O'Reilly Default Stylesheet and Word List.
- Purdue University Online Writing Lab (OWL).
- Fedora Documentation Project.
- Ubuntu Documentation Team.
- KDE Style Guide.
- GNOME Style Guide.
- Wikipedia Article on Style Guides.