Working on a style guide

Belinda Lopez belinda.lopez at canonical.com
Sun Jun 14 18:38:28 UTC 2009


Belinda Lopez wrote:
> Phil Bull wrote:
>> Hi Matt,
>>
>> On Sun, 2009-06-14 at 16:10 +0100, Matthew East wrote:
>>   
>>> It sounds good, but don't we already have a style guide? Wouldn't it
>>> be better to work on identifying the weaknesses in the existing one
>>> and improving it rather than writing a new one from scratch?
>>>     
>>
>> It depends on how suitable the current style guide is for its target
>> audience (us, new contributors, etc). We should start by defining
>> precisely what the style guide should be and what it should achieve.
>> Once we know what the aims of the document are, then we can see whether
>> the old material is compatible with those aims or not.
>>
>> So, what exactly do people expect from a style guide? What questions are
>> people likely to have about style, and what should people know about our
>> style?
>>
>> Thanks,
>>
>> Phil
>>
>>   
> I just went on our wiki site to look at the Style Guide and it was 
> basically a link to the Gnome Style Guide - which makes sense.  But 
> since Phil and I are sitting here with the Gnome Documentation Team 
> today discussing a shared style guide are there any Ubuntu specific 
> guidelines? or where should I be looking for those items?
>
> thanks,
>
> Belinda
>
Ah, nevermind - I see how the content is divided up now.  But just FYI 
the Gnome folks are telling us their Style Guide is out of date and 
needs some attention.  We're looking at ways to help them with that 
process that will benefit both projects and others.

cheers
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20090614/8b59314a/attachment.html>


More information about the ubuntu-doc mailing list