W3C home > Mailing lists > Public > wai-eo-editors@w3.org > June 2017

[style guide] abbreviations and acronyms - general best practice

From: Shawn Henry <shawn@w3.org>
Date: Fri, 30 Jun 2017 11:52:44 -0500
To: wai-eo-editors <wai-eo-editors@w3.org>
Message-ID: <e23c6208-e7ff-656b-20e1-d6cd465ae9a3@w3.org>
I made these suggested revisions:
	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 16:53:15 UTC

This archive was generated by hypermail 2.4.0 : Tuesday, 23 June 2020 20:41:51 UTC