From Fedora Project Wiki

m (1 revision(s))
m (Sparks moved page Docs Project Style Guide to Archive:Docs Project Style Guide: Moved to guide)
 
(10 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{:DocsProject/Header}}
+
{{Moved to guide}}
 +
{{header|docs}}
  
 
= Fedora Documentation Style Guide =
 
= Fedora Documentation Style Guide =
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'''
  
1. [[/IntroductionToStyle| Introduction to Style]]  
+
# [[Docs Project Style Guide - Introduction to Style|Introduction to Style]]  
1. [[/GeneralGuidelines| General Guidelines]]  
+
# [[Docs Project Style Guide - General Guidelines|General Guidelines]]  
1. [[/ContentAndRendering| Content and Rendering]]  
+
# [[Docs Project Style Guide - Content and Rendering|Content and Rendering]]  
1. [[/DatesAndTimes| Dates and Times]]  
+
# [[Docs Project Style Guide - Dates and Times|Dates and Times]]  
1. [[/FedoraSpecific| Fedora-Specific Conventions]]  
+
# [[Docs Project Style Guide - Fedora Specific|Fedora-Specific Conventions]]  
1. [[/CommonMistakes| Common Mistakes]]  
+
# [[Docs Project Style Guide - Common Mistakes|Common Mistakes]]  
1. [[/QuickReference| Quick Reference]]  
+
# [[Docs Project Style Guide - Word usage, capitalization, and spelling|Word Usage, Capitalization, and Spelling]]
1. [[/Resources| Resources]]  
+
# [[Docs Project Style Guide - Quick Reference|Quick Reference]]  
 +
# [[Docs Project Style Guide - Resources|Resources]]
  
----
+
[[Category:Docs Project process]]
[[Category:DocsProject]]
+
[[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