Move json generation script to subfolder with its own README (#4635)

This gives us a dedicated place to document wcag.json and where it is
published.

I re-ran the build with `WCAG_JSON=1` to confirm that moving the script
still works correctly; output is unchanged.

Author: kfranqueiro

11ty/README.md

@@ -183,6 +183,8 @@ Generates `_site/wcag.json`. (This is not done by default, as it adds to build t
 
 **Default:** Unset by default; `publish-w3c` scripts set this to a non-empty value.
 
+For more information on the output, see [11ty/json/README.md](json#readme).
+
 ### `GITHUB_REPOSITORY`
 
 **Usage context:** Automatically set during GitHub workflows; should not need to be set manually

11ty/json/README.md

@@ -0,0 +1,25 @@
+# JSON Serialization of WCAG 2
+
+The script in this folder serializes WCAG 2 information into JSON format, including:
+
+- Principles, guidelines, and success criteria
+- Glossary terms
+- Associations between (normative) success criteria and (informative) techniques
+
+The following JSON files are published monthly:
+
+- [WCAG 2.2 JSON](https://www.w3.org/WAI/WCAG22/wcag.json)
+- [WCAG 2.1 JSON](https://www.w3.org/WAI/WCAG21/wcag.json)
+
+For a history of structural changes to the JSON files, see the [list of merged wcag.json pull requests](https://github.com/w3c/wcag/pulls?q=is%3Apr+label%3Awcag.json), and in particular the "wcag.json Changes" section in each pull request description.
+
+## Permission to use with attribution
+
+You may use this data, in full or in part, provided you:
+
+- Clearly attribute the original source and include a link to it ([Web Content Accessibility Guidelines (WCAG) 2.2](https://www.w3.org/TR/WCAG22/),  [Techniques for WCAG 2.2](https://www.w3.org/WAI/WCAG22/Techniques/), [Web Content Accessibility Guidelines (WCAG) 2.1](https://www.w3.org/TR/WCAG21/), [Techniques for WCAG 2.1](https://www.w3.org/WAI/WCAG21/Techniques/))
+- Do not change the content
+
+If you include additional information, it must be clear what is from the W3C WCAG documents and what is added.
+
+See [W3C Document license](https://www.w3.org/copyright/document-license/) and [W3C Intellectual rights](https://www.w3.org/copyright/intellectual-rights/), particularly '[May I annotate one of your specifications?](https://www.w3.org/copyright/intellectual-rights/#annotate)'.

11ty/json.ts renamed to 11ty/json/index.ts

@@ -14,8 +14,8 @@ import type {
 } from "understanding/understanding";
 import eleventyUnderstanding from "understanding/understanding.11tydata";
 
-import { type CheerioAnyNode } from "./cheerio";
-import { resolveDecimalVersion } from "./common";
+import { type CheerioAnyNode } from "../cheerio";
+import { resolveDecimalVersion } from "../common";
 import {
   type SuccessCriterion,
   type WcagVersion,
@@ -25,7 +25,7 @@ import {
   assertIsWcagVersion,
   getFlatGuidelines,
   generateScSlugOverrides,
-} from "./guidelines";
+} from "../guidelines";
 import {
   expandTechniqueToObject,
   getFlatTechniques,
@@ -34,7 +34,7 @@ import {
   type Technique,
   type TechniqueAssociationType,
   type Technology,
-} from "./techniques";
+} from "../techniques";
 
 const removeNewlines = (str: string) => str.trim().replace(/\n\s+/g, " ");