Improving the Design Guide contents

I'd like to discuss my thoughts on the Design Guide in this week's TF 
meeting and also think about what might be done in the Content Usable 
release timescale.

As noted in our planning page I've been looking at ways to further 
improve the Design Guide content for Designers and developers. I've also 
kept in mind our plans for making the guide available as both a note and 
web version.

In GitHub Issue 154 I've noted the kinds of changes I'd like to see. 
These range for simple editorial to adding new sections for the web version.

Concentrating on the Pattern "Clearly Identify Controls and Their Use" 
as an example, I have provided:

* comments in a Google document copy of the current text
   * 
https://docs.google.com/document/d/1nVTsmgts92i5_D7-oA9r87FxzXp_F9ndt_8mZ1aaM90/edit?usp=sharing

* a "suggesting edits" Google doc for "diffs"
   * 
https://docs.google.com/document/d/1WM3RjjRuCOV6aPdy4PpmRmqdugLt6Ny5dD3KGd8LTF4/edit?usp=sharing

* a final draft in a Google doc
   * 
https://docs.google.com/document/d/14Dfa62yH6YzYZCcaBxOoovYbL84AMzHC2vXUzh7_Wuk/edit?usp=sharing

Thanks

Steve

1: https://github.com/w3c/coga/issues/154

Received on Monday, 31 August 2020 12:53:41 UTC