Re: Yahoo Style Guide No Longer Available

Yes to writing our own. We can use the UK Gov styleguide as a starting
point and expand from there with what is needed.

I think it would be best to start a GitHub repo for this work, something
like Webplatform/Writing-Styleguide. That way other projects could easily
use it if they wanted to.

Nic Da costa, this styleguide is for the actual writing of content, not
code styles. There has already been some work going into code style-guides
for the docs. In the end though we should probably just reference other
pre-existing and used style-guides such as Google's [1].


-Garbee

[1] http://google-styleguide.googlecode.com/svn/trunk/htmlcssguide.xml


On Thu, Aug 22, 2013 at 5:21 AM, Nic da Costa <njr.dacosta@gmail.com> wrote:

> Hey Doug
>
> My two cents worth, I like that idea of adapting an existing one to better
> suite our needs and like you said, thus filling the gap that has been left.
> I also think it would go nicely with the fact that we are documenting the
> web. Not only can you view the properties, but also a style guide to help
> you write cleaner code, etc.
>
> // Nic da Costa
>
>
>
> On 22 August 2013 11:08, Doug Schepers <schepers@w3.org> wrote:
>
>> Hi, folks–
>>
>> We reference the Yahoo! Style Guide as our style guide; at the time we
>> made that decision, the online version of the Yahoo! Style Guide was free.
>>
>> Apparently, sometime in June they took down the online version, and
>> started pointing instead to printed (commercial) versions.
>>
>> We have a few options at this point
>> * continue to point at the Yahoo! Style Guide, which is (for now, anyway)
>> still available on Archive.org [1]
>> * point to a different resource [2], noting that only Yahoo! had
>> comprehensive focus on online writing
>> * adapt an existing one that has an open license and is close enough [3]
>> * write our own
>> * something else
>>
>> Personally, I like the idea of adapting the Gov.uk style guide to our
>> use, giving them attribution of course.
>>
>>
>> Writing our own or adapting one gives us an interesting longer-term
>> opportunity to fill the void that Yahoo! has left, specifically focused
>> perhaps on writing online documentation. But that may be a bit ambitious
>> and meta to consider now.
>>
>> [1] http://web.archive.org/web/**20121014054923/http://**
>> styleguide.yahoo.com/<http://web.archive.org/web/20121014054923/http://styleguide.yahoo.com/>
>> [2] http://www.dailywritingtips.**com/5-online-style-guides/<http://www.dailywritingtips.com/5-online-style-guides/>
>> [3] https://www.gov.uk/**designprinciples/styleguide<https://www.gov.uk/designprinciples/styleguide>
>>
>> Regards-
>> -Doug
>>
>>
>