[closed] Re: [style guide] abbreviations and acronyms - general best practice

I made separate sections:
* Specific Styles for WAI Material
* General Good Practice

Feel free to tweaks the headings.

Unless others have different ideas, I propose we call this issue/thread closed.

~Shawn


On 6/30/2017 12:17 PM, Bakken, Brent wrote:
> I agree with this approach in a general sense. I would like to caution that not all participants are up to speed on general writing best practices as you are, because they may have never written a book, journal, or professional web content before.
> 
> I like the idea of having this stuff somewhere, just not the main focus of the style guide. Keep main focus specific to WAI web site content writing.
> 
> *__*
> 
> Brent A. Bakken
> Director, Accessibility Strategy & Education Services
> Pearson
> 
> 512 202 1087
> brent.bakken@pearson.com <mailto:brent.bakken@pearson.com>
> 
> Learn more at pearson.com <http://pearson.com>
> Pearson
> 
> 
> 
> On Fri, Jun 30, 2017 at 11:52 AM, Shawn Henry <shawn@w3.org <mailto:shawn@w3.org>> wrote:
> 
>     I made these suggested revisions:
>     https://www.w3.org/WAI/EO/wiki/index.php?title=Style&diff=20359&oldid=20357 <https://www.w3.org/WAI/EO/wiki/index.php?title=Style&diff=20359&oldid=20357>
> 
>     However, I'm not convinced that we even want this point in this Style Guide at all. It is general best practice, and perhaps it's more clutter than helpful?
> 
>     One idea is that we have a section for reminders of general best practice that includes points like this, and that section is separate so it's easier for people to focus on the more specific issues?
> 
>     On 6/30/2017 11:40 AM, Shawn Henry wrote:
> 
>         I think that we want this Style Guide to be as short and easy-to-consume as feasible. If so, we'll want to be thoughtful about what we include and what not to clutter it with. For example, maybe we don't need to include obvious things, and certainly we don't want to recreate general writing best practices.
> 
> 
> 
>     Thoughts?
> 
>     ~Shawn
> 
>

Received on Friday, 30 June 2017 19:51:19 UTC