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