Modify title element for screen reader users

[jnurthen]

When viewing a preview there is a really prominent notice so visual users know they are viewing the preview version. Screen reader users are unlikely to get to this content as they are not likely to read that part of the document.
I suggest modifying the document title element with a short prefix to denote that this is a preview. For example modify the title to
"Preview of PR xxx: "

[tobie]

That's a great idea. It would need to happen on ReSpec and Bikeshed themselves. Pinging @marcoscaceres and @tabatkins.

[tabatkins]

Bikeshed allows you to specify different values for <title> and <h1>; the Title metadata covers both by default, but H1 will provide a different value for the <h1> instead.

So presumably pr-preview could fill that in or something?

[tobie]

ReSpec has a preview template and it makes changing these things way easier.

[tobie]

More clearly, for PR Preview to be able to prefix the title element, it would either need to do some parse and replace on the output of the Bikeshed server, or request that every config file also include the title of the spec. On the other hand, if Bikeshed had a preview template or mode, the prefixing could be automatic.

[tobie]

Now if you wanted titles to just be "Preview of PR ###" without any reference to the title of the document itself, than that's a lot easier to organize on my side.

[tabatkins]

More clearly, for PR Preview to be able to prefix the title element, it would either need to do some parse and replace on the output of the Bikeshed server, or request that every config file also include the title of the spec. On the other hand, if Bikeshed had a preview template or mode, the prefixing could be automatic.

Hm, Bikeshed could use a fix here. I compute all the macros and sub them in when doing "computed-metadata" defaults, but I don't provide that for anything else. So you can't "build on" the existing [TITLE] macro from command-line metadata.

But I'm not opposed to having a special-purpose mode that amends the title for you and maybe adds some metadata to the header.

[marcoscaceres]

Filed https://github.com/w3c/respec/issues/2030 on the ReSpec side. As it's a "good first issue," trying to find someone to work on it.