code consistency

Hannie Dumoleyn lafeber-dumoleyn2 at zonnet.nl
Mon Mar 2 11:38:14 UTC 2015


Op 28-02-15 om 20:18 schreef Stephen M. Webb:
> On 15-02-28 05:52 AM, Hannie Dumoleyn wrote:
>> In unity-introduction.page I see the word The Dash in 3 different ways:
>> The <gui>Dash</gui>
>> The <em>Dash</em>
>> the Dash
> I would suggest that the first use of the term be displayed as "the <em>Dash</em>" and all following uses simply be "the
> Dash."
>
> Unlike quoted strings or other callouts, the name "Dash" is just a proper noun and should be treated as such.  The same
> goes for other components of Unity such as the Panel, the Launcher, and the Switcher.
>
> I'm of the school that believes the gratuitous overuse of special type is distracting and amateurish.
>
Good suggestion/comment again, Stephen.
At UMP we have a style guide, see [1], written by Kevin. It is an 
excellent guide for those who are new to the team.
The docs-team has its wiki pages with info for newcomers, but is there 
also a page with rules for the styling/formatting codes?
Hannie

[1]
http://files.ubuntu-manual.org/style-guide.pdf





More information about the ubuntu-doc mailing list