[Tips pages] Titles are quite long

hidde commented 5 years ago

I found these titles quite long:

Tips for Getting Started Writing for Web Accessibility Tips for Getting Started Designing for Web Accessibility Tips for Getting Started Developing for Web Accessibility

and the second “for” made me read twice.

What about:

Tips for Copy Writers Tips for Designers Tips for Developers

(because web, accessibility, tips and possibly even also getting started are implied?)

hidde commented 5 years ago

cc @slhenry (if you agree I'm happy to do the work)

shawna-slh commented 5 years ago

Hi Hidde. It is good to have your input. There is a lot of EOWG background behind these titles. We would need to get up-to-speed on what went into the decisions to use those titles. And then re-open it with EOWG. I have several thoughts, but cannot prioritize spending time on it right now. Please put this on hold, and we'll see if we can get to it with other work later. Thanks!

hidde commented 5 years ago

thanks for the reply, I had suspected there would be some context to this… On hold it is!

yatil commented 5 years ago

Also, the titles can be shorter when I finalize the implementation of resource titles: https://github.com/w3c/wai-website/issues/157 (hopefully next week)

hidde commented 5 years ago

Nice, thanks for the link @yatil

shawna-slh commented 5 years ago

Briefly, a few of the points:

Similar jobs have different titles, especially around the world. Also, in a small organization, one person might do multiple roles. For these and other reasons, EOWG preferred to focus on the task rather than the role for these and some other resources. From Quick Start Guides/Requirements Analysis:
"Note: At the EO meeting of 1st May 2015 it was agreed to use an activity or task based approach rather than a role based approach, for example Designing instead of Designers."
These are 3 of 6+ planned "Tips for Getting Started with Accessibility". Some of the others are different. (Not sure if and when we'll get to the others.)

tips and possibly even also getting started are implied

It needs to be very clear that these are just a few "tips for getting started" -- they are not comprehensive at any level.

(because web, accessibility, … are implied

For readers who are familiar with the WAI website or look around and figure that out, yes. However, some people might land on this page without any context. Also, good to have those words in title for SEO Also, title will be used out of context, including:

in search engine results
other resources, blogs, tweets, etc. that mention these pages

There is a line break on the H1s:

Tips for Getting Started
Writing for Web Accessibility

and we'll still continue to work on improvements! :-)

w3c / wai-website

[Tips pages] Titles are quite long #722