w3c / wcag

Web Content Accessibility Guidelines
https://w3c.github.io/wcag/guidelines/22/
Other
1.14k stars 257 forks source link

Clean up gh-pages #3952

Closed kfranqueiro closed 4 months ago

kfranqueiro commented 4 months ago

The gh-pages branch contains many files/directories that haven't been actively updated in many years. This PR removes everything that is not currently relevant to the deploy action on the main branch.

In addition to removing old files, this also updates the following:

Preview visible at https://kfranqueiro.github.io/wcag/

(Note that the URLs in the redirect pages mentioned above are hard-coded to the upstream repo)

This PR intentionally does not clear outdated files from under techniques and understanding (since it seems the existing deploy process never removes files to clean up what has been removed from the repository). This can be handled via a deploy script update at a later point in time.

w3cbot commented 4 months ago

kfranqueiro marked as non substantive for IPR from ash-nazg.

kfranqueiro commented 4 months ago

cc @alastc @mbgower @bruce-usab FYI, RE discussion earlier today

kfranqueiro commented 4 months ago
* Do we need a .gitignore on _site? Might just have been because I switched branch and my directory hadn't been cleared out.

_site was added to .gitignore in #3917 (the first Eleventy PR).

* Is the `requirements` directory doing anything?

I'm honestly not sure what it does, but the existing github workflow actively pushes to that directory. I preserved everything that the workflow touches.

kfranqueiro commented 4 months ago

@iadawn Another thing to flag, since I saw your edit to index.html: The only files this cleanup retains are related to 2.1 or 2.2.

Should I restore the WCAG20 and wcag20/wcag21 directories on this branch? (I'm not sure if anything actively references them or if we have any meaningful way of ever updating them.)

Or should we drop mention of 2.0 in index.html?

iadawn commented 4 months ago

_site was added to .gitignore in #3917 (the first Eleventy PR).

Ah ha... _site isn't in the gh-pages branch one. I don't think it is needed though since there isn't a 'build' in that branch. I think I just ended up with it because I swapped branches in GH Client.

I'm honestly not sure what it does, but the existing github workflow actively pushes to that directory. I preserved everything that the workflow touches.

Hmm... I might need to look closer at that. My inclination is to remove it... mostly because I don't like mess!

iadawn commented 4 months ago

Should I restore the WCAG20 and wcag20/wcag21 directories on this branch? (I'm not sure if anything actively references them or if we have any meaningful way of ever updating them.)

Or should we drop mention of 2.0 in index.html?

There isn't an Editor's draft mentioned in WCAG2.0. That would have been my only concern. Can pick this up in our catchup

kfranqueiro commented 4 months ago

Should I restore the WCAG20 and wcag20/wcag21 directories on this branch? (I'm not sure if anything actively references them or if we have any meaningful way of ever updating them.)

Update: restored wcag21/requirements because it is referenced from the recommendation

Or should we drop mention of 2.0 in index.html?

Update: discussed further and removed specific mention of 2.0 since we don't currently target it in builds, and nothing in the 2.0 recommendation links to this repo's gh-pages.