bbc/bbc-a11y

Update a11y documentation links in console warnings

thekp opened this issue ยท 3 comments

thekp commented

Summary

When running this command bbc-a11y https://www.test.bbc.com/pidgin/popular/read I received this console warning:
image

It is a helpful console warinng, however the link it suggested: https://www.bbc.co.uk/guidelines/futuremedia/accessibility/mobile/structure/headings
does not work ๐Ÿ‘€

Expected Behaviour

After some further investigation, I found what I believe to be the correct link: https://www.bbc.co.uk/guidelines/futuremedia/accessibility/html/headings.shtml

Current Behaviour

It is logging a broken link:
image

Possible Solution

Short-term we could possibly update the links in the CLI tool.

A better solution is probably to find out where the routing is done and redirect them to the new links.

Steps to Reproduce (for bugs)

  1. Run bbc-a11y https://www.test.bbc.com/pidgin/popular/read in terminal
  2. View the console warnings
  3. Click the link provided in the console warning
  4. See the broken page.

Context & Motivation

It didn't affect me too much as I was able to find the new URL quite easily.

Your Environment

Hi,

Ah, this is something we know about. The old guidelines site is down while the new site is awaiting a final URL + redirection to be setup.

The link will work again shortly. The link your suggestion is to the HTML standard rather than the Mobile Access Guidelines.

I would suggest we leave this be as the old link will be fixed in the not too distant future and it remains the canonical URL for that content.

J&L

thekp commented

I would suggest we leave this be as the old link will be fixed in the not too distant future and it remains the canonical URL for that content.

Excellent, Thanks for the update @JamieKnightBBC :)

There is already an issue and related PR to cover the changes to guideline URLs to the new site that was published last year. Something about it needed resolved and I couldn't figure it out.

Presuming the new site will still be used, and the merge issues can be resolved, it is ready to go.

Refer PR #297

Incidentally, all of the old Future Media guidelines are earmarked for removal - https://jira.dev.bbc.co.uk/browse/OPS-235659 - including the HTML standard.