Content tweaks for building website (part of issue 2418 task 11)

[alflennik]

The PR includes the practical miscellaneous changes needed to use the new content organization as the starting point to build the APG website. Just one example of the type of changes needed is the fact that the first sentence of each pattern is used as its description and the checkbox pattern did not actually begin with a complete sentence. The broken links were found as part of the link checker effort which itself should have a PR soon.

See related PR w3c/wai-aria-practices#170 for more information.

---

WAI Preview Link failed to build on 'Update site files' step. (Last tried on Fri, 11 Nov 2022 03:39:17 GMT).

[alflennik]

The preview link build failure appears to be caused by a Git Submodule caching issue in Netlify, I will investigate this with Howard and get in contact with Steve at WAI who administers the ARIA-Practices Netlify account.

[mcking65]

@alflennik, I will review this afternoon (pacific time). I will try to do as early as possible so you have the feedbac/merge before end of your day.

When reaching out to Steve, also reach out to @shawna-slh. I believe @michael-n-cooper told me that Steve was leaving at some point. So, there is a possibility he is not managing the netlify account. I might not be remembering correctly, and I don't recall timing. Just want to be sure you are able to get timely response.

[mcking65]

@alflennik, Looks awesome! I made necessary editorial changes. I have a few questions:

1. Curious why img directory is in repo root instead of in say /content/shared/? Seems like we should consider images as part of the content.
2. Should the spec link fixing work if I view files locally in browser? It is not working for me.
3. Should insertion of example warning be working if I view example files locally? It is not working for me.
4. What do you think of renaming /content/index.html to /content/apg-home.html? I suggest this because we have another file named index.html under /content/index.
5. In /content/index.html, Could you please delete the <div id="work" that starts on line 61. We are not using it, and we don't have plans to restore it. It is most likely similar information will eventually end up under /about, and there is no reason to keep it in the home page file.
   Feel free to merge this to move-examples branch whenever you are ready.

[shawna-slh]

Unfortunately, dependency updates broke many Netlify previews. Hopefully we can get those fixed soon.

[alflennik]

@mcking65 The feedback has been addressed, but before I merge I want to give you a chance to take a second pass over the changes I've made since last time which include fixing some garbled text and making the advisements consistent with notes and warnings.

[mcking65]

Thank you @alflennik! Many excellent corrections. Great content quality boost! Just one forward looking question below in the CSS.

[mcking65]

Should we consider specifying h5 even though we don't have any ... yet? There are a couple of practices, like keyboard, where we get down to h4 for subtopics.