From Fedora Project Wiki

m (add categories)
m (Sparks moved page Docs Project Style Guide to Archive:Docs Project Style Guide: Moved to guide)
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
{{Moved to guide}}
 
{{header|docs}}
 
{{header|docs}}
  
Line 8: Line 9:
 
'''Documentation Summary:'''
 
'''Documentation Summary:'''
  
'''Purpose:''' Defining specific style guidelines for use in Fedora Documentation
+
'''Purpose:''' Define specific style guidelines for Fedora Documentation
  
'''Audience:''' Fedora Documentation and Fedora Website writers and editors
+
'''Audience:''' Members of Fedora Documentation Project and Fedora Websites Project
  
'''Assumptions:''' The reader must be familiar with the English language, including the basic language syntax.
+
'''Assumptions:''' You should be familiar with the English language, including the basic language syntax.
  
'''Related Documents:''' The [http://docs.fedoraproject.org/documentation-guide Documentation Guide] outlines the standard practices of the Fedora Documentation Project.
+
'''Related Documents:''' The [http://docs.fedoraproject.org/documentation-guide Documentation Guide] outlines standard practices of the Fedora Documentation Project.
  
 
'''Lead Writer:''' PatrickBarnes
 
'''Lead Writer:''' PatrickBarnes
Line 20: Line 21:
 
----
 
----
  
The Fedora Documentation Project produces documentation of the highest possible quality. To attain this goal, FDP documents must follow a consistent, readable style. The Fedora Documentation Style Guide provides uniform guidelines for specific elements of Fedora Documentation. The Fedora Project uses American English (en_US) as its language of business, and recommends dictionaries published by Merriam-Webster for spelling reference.
+
The Fedora Documentation Project produces documentation of the highest possible quality. To attain this goal, Documentation Project documents follow a consistent, readable style. The ''Fedora Documentation Style Guide'' provides uniform guidelines for specific elements of Fedora documentation. The Fedora Project uses American English (en_US) primarily. We recommend dictionaries published by Merriam-Webster for spelling reference.
 
 
[[/FullGuide|  View the Full Guide]]
 
  
 
'''Table of Contents'''
 
'''Table of Contents'''
  
# [[/IntroductionToStyle|Introduction to Style]]  
+
# [[Docs Project Style Guide - Introduction to Style|Introduction to Style]]  
# [[/GeneralGuidelines|General Guidelines]]  
+
# [[Docs Project Style Guide - General Guidelines|General Guidelines]]  
# [[/ContentAndRendering|Content and Rendering]]  
+
# [[Docs Project Style Guide - Content and Rendering|Content and Rendering]]  
# [[/DatesAndTimes|Dates and Times]]  
+
# [[Docs Project Style Guide - Dates and Times|Dates and Times]]  
# [[/FedoraSpecific|Fedora-Specific Conventions]]  
+
# [[Docs Project Style Guide - Fedora Specific|Fedora-Specific Conventions]]  
# [[/CommonMistakes|Common Mistakes]]  
+
# [[Docs Project Style Guide - Common Mistakes|Common Mistakes]]  
# [[/QuickReference|Quick Reference]]  
+
# [[Docs Project Style Guide - Word usage, capitalization, and spelling|Word Usage, Capitalization, and Spelling]]
# [[/Resources|Resources]]
+
# [[Docs Project Style Guide - Quick Reference|Quick Reference]]  
 +
# [[Docs Project Style Guide - Resources|Resources]]
  
 
[[Category:Docs Project process]]
 
[[Category:Docs Project process]]
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Latest revision as of 14:48, 22 March 2014

Important.png
Old page
The data in this page has been incorporated into a formal guide and is no longer being maintained.
DocsProject Header docTeam1.png


Fedora Documentation Style Guide

Documentation Summary:

Purpose: Define specific style guidelines for Fedora Documentation

Audience: Members of Fedora Documentation Project and Fedora Websites Project

Assumptions: You should be familiar with the English language, including the basic language syntax.

Related Documents: The Documentation Guide outlines standard practices of the Fedora Documentation Project.

Lead Writer: PatrickBarnes


The Fedora Documentation Project produces documentation of the highest possible quality. To attain this goal, Documentation Project documents follow a consistent, readable style. The Fedora Documentation Style Guide provides uniform guidelines for specific elements of Fedora documentation. The Fedora Project uses American English (en_US) primarily. We recommend dictionaries published by Merriam-Webster for spelling reference.

Table of Contents

  1. Introduction to Style
  2. General Guidelines
  3. Content and Rendering
  4. Dates and Times
  5. Fedora-Specific Conventions
  6. Common Mistakes
  7. Word Usage, Capitalization, and Spelling
  8. Quick Reference
  9. Resources