Difference between revisions of "Wiki Team/Guide/Style Guide"

From Sugar Labs
Jump to navigation Jump to search
(No difference)

Revision as of 12:40, 15 March 2009

Introduction

The pages in this wiki should be as easy to understand and follow as possible. With this in mind, please take into account the following suggested writing style guidelines:

Terminology

  • Sugar releases - Always try to specify which versions of Sugar a page is valid for. When referring to Sugar releases, use "Sugar X.XX" - eg. "Sugar 0.82".
  • Linux distributions - Capitalize the names of Linux distributions like Fedora, Debian, Ubuntu, etc.
  • Operating Systems - Capitalize the names of operating systems like Linux, Ubuntu, Windows, etc.

Page Titles

  • Be descriptive.
  • Avoid using the word "Howto" in the page title (everything here is a howto!).
  • Use capital letters and avoid dashes.
  • Avoid camel casing, such as 'WikiTeam', because search engines will not find this 'Team', so 'Wiki Team', then. (We are in the process of converting away from CamelCase contractions, so you may see many examples of the deprecated style.)

Section Headings

  • Heading text should be short, clear, and descriptive.
  • Capitalize in the following manner:
    • Initial uppercase letter for the first word and the last word, regardless of part of speech
    • Initial uppercase letter for all nouns, adjectives, and verbs
    • Initial uppercase letter for conjunctions of four letters or longer
    • Initial uppercase letter for prepositions of four letters or longer
    • Initial uppercase letter for prepositions that are part of a phrasal verb
    • All lowercase letters for conjunctions, articles, and prepositions of less than four letters

(Taken from the GNOME Style Guide)

Lists

Bullet lists of links should take the following form: <Bullet> <Link> <Hyphen> <Sentence>.

  • For example:
    • Skype - Internet telephony software (closed source).