From 82ab4478702c4a7cbd0c44bec22725bd28e31421 Mon Sep 17 00:00:00 2001 From: "Kenneth G. Franqueiro" Date: Fri, 19 Jul 2024 18:07:55 -0400 Subject: [PATCH 1/3] Remove superseded build tasks; remove generated file --- 11ty/CustomLiquid.ts | 2 +- build.xml | 246 +----- understanding/toc.html | 176 ---- xslt/generate-techniques-toc.xslt | 57 -- xslt/generate-techniques.xslt | 636 -------------- xslt/generate-understanding-toc.xslt | 56 -- xslt/generate-understanding.xslt | 1140 -------------------------- xslt/process-index.xslt | 50 -- 8 files changed, 2 insertions(+), 2361 deletions(-) delete mode 100644 understanding/toc.html delete mode 100644 xslt/generate-techniques-toc.xslt delete mode 100644 xslt/generate-techniques.xslt delete mode 100644 xslt/generate-understanding-toc.xslt delete mode 100644 xslt/generate-understanding.xslt delete mode 100644 xslt/process-index.xslt diff --git a/11ty/CustomLiquid.ts b/11ty/CustomLiquid.ts index 9f8da18338..c241956edc 100644 --- a/11ty/CustomLiquid.ts +++ b/11ty/CustomLiquid.ts @@ -16,6 +16,7 @@ import { techniqueToUnderstandingLinkSelector } from "./understanding"; const titleSuffix = " | WAI | W3C"; +/** Matches index and about pages, traditionally processed differently than individual pages */ const indexPattern = /(techniques|understanding)\/(index|about)\.html$/; const techniquesPattern = /\btechniques\//; const understandingPattern = /\bunderstanding\//; @@ -85,7 +86,6 @@ export class CustomLiquid extends Liquid { public parse(html: string, filepath?: string) { // Filter out Liquid calls for computed data and includes themselves if (filepath && !filepath.includes("_includes/") && isHtmlFileContent(html)) { - /** Matches paths that would go through process-index.xslt in previous process */ const isIndex = indexPattern.test(filepath); const isTechniques = techniquesPattern.test(filepath); const isUnderstanding = understandingPattern.test(filepath); diff --git a/build.xml b/build.xml index 6b4d414ddb..826a539a19 100644 --- a/build.xml +++ b/build.xml @@ -172,247 +172,6 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -445,10 +204,7 @@ - - - - \ No newline at end of file + diff --git a/understanding/toc.html b/understanding/toc.html deleted file mode 100644 index 37f2094881..0000000000 --- a/understanding/toc.html +++ /dev/null @@ -1,176 +0,0 @@ -
-

Perceivable

-
-

1.1 Text Alternatives

- -
-
-

1.2 Time-based Media

- -
-
-

1.3 Adaptable

- -
-
-

1.4 Distinguishable

- -
-
-
-

Operable

-
-

2.1 Keyboard Accessible

- -
-
-

2.2 Enough Time

- -
-
-

2.3 Seizures and Physical Reactions

- -
- -
-

2.5 Input Modalities

- -
-
-
-

Understandable

-
-

3.1 Readable

- -
-
-

3.2 Predictable

- -
-
-

3.3 Input Assistance

- -
-
-
-

Robust

-
-

4.1 Compatible

- -
-
-
-

Other Understanding documents

- -
\ No newline at end of file diff --git a/xslt/generate-techniques-toc.xslt b/xslt/generate-techniques-toc.xslt deleted file mode 100644 index b9b361ee23..0000000000 --- a/xslt/generate-techniques-toc.xslt +++ /dev/null @@ -1,57 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - ARIA Techniques - Client-Side Script Techniques - CSS Techniques - Common Failures - Flash Techniques - General Techniques - HTML Techniques - PDF Techniques - Server-Side Script Techniques - Silverlight Techniques - SMIL Techniques - Plain-Text Techniques - - -

- - ยง -

-
    - - - -
- - - -
  • - : -
    • -     - -     \ No newline at end of file diff --git a/xslt/generate-techniques.xslt b/xslt/generate-techniques.xslt deleted file mode 100644 index 14564e9cb9..0000000000 --- a/xslt/generate-techniques.xslt +++ /dev/null @@ -1,636 +0,0 @@ - - - - - - techniques/ - output/ - technique-assocations.xml - ../guidelines/wcag.xml - - - - - - - -
    -
    - -
    -
    -     - - - - - - - - - - : - - an unwritten technique - - - - - - - - - - - : - - - - - - - - Sufficient to meet - Advisory for - a Failure of - - - - - - - , if combined with - - - - - and - - - - , using a more specific technique. - - - - - when used with - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -]]> - - - - - - - - - -
    - -
    - - -
    - - - - - - - - -
    - -
    - - - - - -     - - -
    -

    - About this Technique -

    -
    - -
    -
    -     - - - - - <xsl:value-of select="$meta/@id"/>: <xsl:value-of select="//html:h1"/> | WAI | W3C - - - - -

    Technique :

    -     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

    This technique is - - - - and - - .

    -     - - -

    This technique is .

    -     - -

    This technique is not referenced from any Understanding document.

     -     - - - - - -

    Note: Adobe has plans to stop updating and distributing the Flash Player at the end of 2020, and encourages authors interested in creating accessible web content to use HTML.

    -     - -

    Note: Microsoft has stopped updating and distributing Silverlight, and authors are encouraged to use HTML for accessible web content.

    -     -     -     - - - - - -
    -

    Applicability

    - - - - - - - - - -

    Content using WAI-ARIA.

    -     - -

    Content using client-side script (JavaScript, ECMAScript).

    -     - -

    Content using technologies that support CSS.

    -     - - -

    Content implemented in Adobe Flash.

    -     - -

    Content implemented in any technology.

    -     - -

    Content structured in HTML.

    -     - -

    Content implemented in Adobe Tagged PDF.

    -     - -

    Content modified by the server before being sent to the user.

    -     - -

    Content implemented in Microsoft Silverlight.

    -     - -

    Content implemented in Synchronized Multimedia Integration Language (SMIL).

    -     - -

    Content implemented in plain text, including Markdown and similar formats, without use of a structure technology.

    -     -     -     -     - - - - -
    -
    Note
    -

    Adobe has plans to stop updating and distributing the Flash Player at the end of 2020, and encourages authors interested in creating accessible web content to use HTML.

    -
    -     - -
    -
    Note
    -

    Microsoft has stopped updating and distributing Silverlight, and authors are encouraged to use HTML for accessible web content.

    -
    -     -     - - - - - - - - - - - - - - - - - ( - - Sufficient - Advisory - Failure - - - , together with - - - - - and - - - - using a more specific technique - - - - when used with - - - - - ) - - - - - - - - - - - - -

    This technique relates to:

    -
      - -
      • -       -
    -     - -

    This technique relates to .

    -     -

    This technique is not referenced from any Understanding document.

     -     -
    -     - - - - - - -
    -

    Description

    - -
    -     - - Missing or incomplete description section in - -     -     - - - - - -
    -

    Examples

    - -
    -     -     - - - - - - -
    -

    Other sources

    -

    No endorsement implied.

    - -
    -     -     - - - - - - - - - - - - - - - -
    -

    Tests

    - -
    -     - - Missing or incomplete tests section in - -     -     - - - - - -
    -

    Test Rules

    -

    The following are Test Rules related to this Technique. It is not necessary to use these particular Test Rules to check for conformance with WCAG, but they are defined and approved test methods. For information on using Test Rules, see Understanding Test Rules for WCAG Success Criteria.

    -
      - -
      • -       -
    -
    -     -     - - - - -

    - -     -     - - - - - Procedure - - - - - - - - Expected Results - - - - - - - - Example - - - : - - - - - - -

    - -     -     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -     diff --git a/xslt/generate-understanding-toc.xslt b/xslt/generate-understanding-toc.xslt deleted file mode 100644 index 0bba678ceb..0000000000 --- a/xslt/generate-understanding-toc.xslt +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - - - -
    -

    Other Understanding documents

    -
      - -
    -
    -     -     - - -
    -

    - -
    -     - - -
    -

    - - - - -

    -
      - -
    -
    -     - - -
  • - - - - -
    • -     - - -
    • -     - -     \ No newline at end of file diff --git a/xslt/generate-understanding.xslt b/xslt/generate-understanding.xslt deleted file mode 100644 index ca98a8e5d4..0000000000 --- a/xslt/generate-understanding.xslt +++ /dev/null @@ -1,1140 +0,0 @@ - - - - - - input/understanding/ - output/ - - - - - - Guideline - Success Criterion - - - - - - - : - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  • - - - Part of Guideline: - - - - - -
    • - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -     - - - - - - - - - - - - - - - - -     -     - - - - - - -
  • - -
    • -
  • - - - - -
      - - -
    • - - -
      • -       - -
    • - - -
      • -       - - -
    • - - -
      • -       -
    -     -
    • -
  • - - -
    • -     - - - - - - - - - - - - - - Previous - previous - - - - - - - Previous - previous - - - - - - - Previous - previous - - - - - - - Previous - previous - - - - - - - Previous - previous - - - - - - - Previous - previous - - - - - - - Previous - previous - - - - - - - - - - - - - - - - - context - - - - - - - - - - - - - Next - next - - - - - - - Next - next - - - - - - - Next - next - - - - - - - Next - next - - - - - - - Next - next - - - - - - - Next - next - - - - - - - - - - - - - - - - - Previous - previous - - - - - - - Previous - previous - - - - - - - Previous - previous - - - - - - - - - - - - context - - - - - - - - - - - - Next - next - - - - - - - Next - next - - - - - - - - - - - - - - - Guideline - SC - - - - - - - - - - - - - - - - - - : - - - - - - - - - - - - - - -
    -
    - -
    -
    -     - - - - - - - - - - - - - - - - - -
    -

    Success Criteria for this Guideline

    - -
    -     - - - - - Guideline - Success Criterion - - - - - - - (Level ) - : - - - -
    -

    Note

    - - - -
    -     - - - -

    - - - -

    -     - - - - - - - - - - - - - - - - - - - - -

    Key Terms

     - - - -
    -
    -     -     - - - - - -
    -

    Test Rules

    -

    The following are Test Rules for certain aspects of this Success Criterion. It is not necessary to use these particular Test Rules to check for conformance with WCAG, but they are defined and approved test methods. For information on using Test Rules, see Understanding Test Rules for WCAG Success Criteria.

    - -
    -     -     - - - - - - - - Unable to find term "" in " ()"; key terms list will be incomplete. - - - - - - - - - - - - - - - -
    -
    -     - - - - - - - - - - - - - - - - - - -]]> - - - - - - <xsl:apply-templates select="//html:title"/> - <xsl:text> | WAI | W3C</xsl:text> - - - - - - - -
    - -
    -

    - - (Level ) -

    - - - -
    -

    - - Guideline - Success Criterion (SC) -

    -
    - -
    -
    -
    - - - - - - - - - - - - - - -
    - -
    -     - - - -
    - -
    - - - - - -     - - - - - - - - - Understanding - - - - - - - Understanding - - - Guideline - SC - - : - - - - - - - -

    In Brief

    - -     -     - - - - -

    Intent

    - -     -     - - - - -

    Benefits

    - -     -     - - - - - -

    Examples

    - -     -     -     - - - - - -

    Related Resources

    -

    Resources are for information purposes only, no endorsement implied.

    - -     -     -     - - - - -

    Techniques

    -

    Each numbered item in this section represents a technique or combination of techniques that the WCAG Working Group deems sufficient for meeting this Success Criterion. However, it is not necessary to use these particular techniques. For information on using other techniques, see Understanding Techniques for WCAG Success Criteria, particularly the "Other Techniques" section.

    - -     -     - - - - - -

    Sufficient Techniques

    - -

    Select the situation below that matches your content. Each situation includes techniques or combinations of techniques that are known and documented to be sufficient for that situation.

    -     - -     -     -     - - - - - -

    Advisory Techniques

    -

    Although not required for conformance, the following additional techniques should be considered in order to make content more accessible. Not all techniques can be used or would be effective in all situations.

    - -     -     -     - - - - - -

    Advisory Techniques

    -

    Specific techniques for meeting each Success Criterion for this guideline are listed in the understanding sections for each Success Criterion (listed below). If there are techniques, however, for addressing this guideline that do not fall under any of the success criteria, they are listed here. These techniques are not required or sufficient for meeting any success criteria, but can make certain types of Web content more accessible to more people.

    - -     -     -     - - - - - -

    Failures

    -

    The following are common mistakes that are considered failures of this Success Criterion by the WCAG Working Group.

    - -     -     -     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -     diff --git a/xslt/process-index.xslt b/xslt/process-index.xslt deleted file mode 100644 index de38a6ae73..0000000000 --- a/xslt/process-index.xslt +++ /dev/null @@ -1,50 +0,0 @@ - - - - - - - - - - - - - -]]> - - - - - - - - - - - - - - - - - - - \ No newline at end of file From c58f5c2003d39245ecf4b42cf4124d5c0970e106 Mon Sep 17 00:00:00 2001 From: "Kenneth G. Franqueiro" Date: Fri, 19 Jul 2024 18:09:00 -0400 Subject: [PATCH 2/3] Update documentation to reflect Eleventy build process --- 11ty/README.md | 2 +- README.md | 36 +++++++++++++++++++++++++++++------- 2 files changed, 30 insertions(+), 8 deletions(-) diff --git a/11ty/README.md b/11ty/README.md index 048dab7cb4..4eb77c5a0b 100644 --- a/11ty/README.md +++ b/11ty/README.md @@ -74,6 +74,6 @@ when `WCAG_MODE=editors` is also set. - The main configuration can be found in top-level `eleventy.config.ts` - Build commands are defined in top-level `package.json` under `scripts`, and can be run via `npm run ` -- If you see files named `*.11tydata.js`, these contribute data to the Eleventy build +- If you see files named `*.11tydata.*`, these contribute data to the Eleventy build (see Template and Directory Data files under [Sources of Data](https://www.11ty.dev/docs/data/#sources-of-data)) diff --git a/README.md b/README.md index da9fd8326b..7d7728dad6 100644 --- a/README.md +++ b/README.md @@ -11,11 +11,13 @@ This repository is used to develop content for WCAG 2, as well as associated und * Avoid use of RFC2119 terms such as "must", "shall", or "may" in non-normative content, to avoid confusion with normative role. +See also: [WCAG 2 Style Guide](https://github.com/w3c/wcag/wiki/WCAG-2-style-guide) + ## File Structure WCAG 2.0 was maintained in a different file structure than subsequent versions of WCAG. Source files for WCAG 2.0 are in the wcag20 folder and exists primarily for archival purposes. Do not edit content in that folder. -Content for WCAG 2.1 and later is organized accordign to the file structure below. The WCAG repository contains source and auxiliary files for WCAG 2, Understanding WCAG 2, and eventually techniques. It also contains auxiliary files that support automated formatting of the document. To facilitate multi-party editing, each success criterion is in a separate file, consisting of a HTML fragment that can be included into the main guidelines. Key files include: +Content for WCAG 2.1 and later is organized according to the file structure below. The WCAG repository contains source and auxiliary files for WCAG 2, Understanding WCAG 2, and eventually techniques. It also contains auxiliary files that support automated formatting of the document. To facilitate multi-party editing, each success criterion is in a separate file, consisting of a HTML fragment that can be included into the main guidelines. Key files include: * guidelines/index.html - the main guidelines file * guidelines/sc//*.html - files for each success criterion @@ -79,14 +81,16 @@ Values you provide are described below. Refer to [Success Criterion 2.2.1](https ### Definitions -If you providing term definitions along with your SC, include them in the glossary. Position them in the appropriate alphabetical order with the rest of the terms and use the following format: +If you are providing term definitions along with your SC, include them in the respective `guidelines/terms/{version}` directory, one-per-file, using the following format: ```html -
    {Term}
    +
    {Term}
    {Definition}
    ``` -The ```dfn``` element tells the script that this is a term and causes special styling and linking features. To link to a term, use an `` element without an `href` attribute; if the link text is the same as the term, the link will be correctly generated. For example, if there is a term `web page` on the page, a link in the form of `web page` will result in a proper link. If the link text has a different form from the canonical term, e.g., "web pages" (note the plural), you can provide a hint on the term definition with the `data-lt` attribute. In this example, modify the term to be `web page`. Multiple alternate names for the term can be separated with pipe characters, with no leading or trailing space, e.g., `web page`. +The ```dfn``` element tells the script that this is a term and causes special styling and linking features. To link to a term, use an `` element without an `href` attribute; if the link text is the same as the term, the link will be correctly generated. For example, if there is a term `web page` on the page, a link in the form of `web page` will result in a proper link. + +If the link text has a different form from the canonical term, e.g., "web pages" (note the plural), you can provide a hint on the term definition with the `data-lt` attribute. In this example, modify the term to be `web page`. Multiple alternate names for the term can be separated with pipe characters, with no leading or trailing space, e.g., `web page`. ## Editing Draft Understanding Content @@ -111,8 +115,6 @@ The [technique template](techniques/technique-template.html) shows the structure Techniques can use a temporary style sheet to facilitate review of drafts. This style sheet is replaced by other style sheets and structure for formal publication. To use this style sheet, add `` to the head of the technique. -The generator used to publish techniques uses XML processing, so techniques must be well-formed XML. Techniques use HTML 5 structure so are actually [HTML Polyglot](https://www.w3.org/TR/html-polyglot/). - ### Images, Examples, Cross References for Techniques Techniques can include images. Place the image file in the `img` folder of the relevant technology - meaning all techniques for a technology share a common set of images. Use a relative link to load the image. Most images should be loaded with a `
    ` element and labeled with a `
    ` positioned at the bottom of the figure. `
    ` elements must have an `id` attribute. Small inline images may be loaded with a `` element with suitable `alt` text. @@ -155,10 +157,30 @@ Once a technique branch and file is set up, populate the content and request rev ### Formatting Techniques -Techniques in the repository are plain HTML files with minimal formatting. For publication to the editors' draft and W3C location, techniques are formatted by an XSLT-based generator managed by Apache Ant running in Java. Most people do not need to worry about this, but relevant files are the [Ant build file](build.xml) and [XSLT files](xslt). +Techniques in the repository are plain HTML files with minimal formatting. For publication to the editors' draft and W3C location, techniques are formatted by a build process based on Eleventy for templating and Cheerio for transformations. More details, including instructions for previewing locally, can be found in the [build process README](11ty/README.md). The generator compiles the techniques together as a suite with formatting and navigation. It enforces certain structures, such as ordering top-level sections described above and standardizing headings. It attempts to process cross reference links to make sure the URIs work upon publication. One of the most substantial roles is to populate the Applicability section with references to the guidelines or success criteria to which the technique relates. The information for this comes from the Understanding documents. Proper use of the technique template is important to enable this functionality, and mal-formed techniques may cause the generator to fail. +### Obsolete Techniques + +Obsolete techniques should not be removed from the repository. Instead, they can be marked using YAML front-matter. For example: + +```yaml +--- +obsoleteSince: 22 +obsoleteMessage: | + This failure relates to 4.1.1: Parsing, which was removed as of WCAG 2.2. +--- +``` + +* `obsoleteSince` indicates the earliest version of WCAG 2 when the technique became obsolete + (this may be set to `20` if it should effectively be obsolete for all versions, e.g. for + techniques involving deprecated HTML elements) +* `obsoleteMessage` indicates a message to be displayed within the About this Technique section + +In cases where entire technologies are obsolete (e.g. Flash and Silverlight), these properties may also be specified at the technique subdirectory level, e.g. via `techniques/flash/flash.11tydata.json`. +Note that this case specifically requires JSON format, as this is consumed by both Eleventy and additional code in the build process used to assemble techniques data. + ## Working Examples Examples in techniques should be brief easy-to-consume code samples of how the technique is used in content. Therefore examples should focus on the specific features the technique describes, and not include related content such as style, script, surrounding web content, etc. From 57f236f2ea528401336fa6daa31a605813742a82 Mon Sep 17 00:00:00 2001 From: "Kenneth G. Franqueiro" Date: Mon, 22 Jul 2024 15:00:58 -0400 Subject: [PATCH 3/3] Fix formatting and markdown processing issues; update master -> main --- README.md | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index 7d7728dad6..24691cedba 100644 --- a/README.md +++ b/README.md @@ -19,12 +19,12 @@ WCAG 2.0 was maintained in a different file structure than subsequent versions o Content for WCAG 2.1 and later is organized according to the file structure below. The WCAG repository contains source and auxiliary files for WCAG 2, Understanding WCAG 2, and eventually techniques. It also contains auxiliary files that support automated formatting of the document. To facilitate multi-party editing, each success criterion is in a separate file, consisting of a HTML fragment that can be included into the main guidelines. Key files include: -* guidelines/index.html - the main guidelines file -* guidelines/sc//*.html - files for each success criterion -* guidelines/terms//*.html - files for each definition -* understanding//*.html - understanding files for each success criterion +* `guidelines/index.html` - the main guidelines file +* `guidelines/sc/{version}/*.html` - files for each success criterion +* `guidelines/terms/{version}/*.html` - files for each definition +* `understanding/{version}/*.html` - understanding files for each success criterion -Where is "20", content came from WCAG 2.0. "21" is used for content introduced in WCAG 2.1, "22" for WCAG 2.2, etc. +Where `{version}` is "20", content came from WCAG 2.0. "21" is used for content introduced in WCAG 2.1, "22" for WCAG 2.2, etc. ## Editing Draft Success Criteria @@ -36,7 +36,7 @@ Where is "20", content came from WCAG 2.0. "21" is used for content in 1. Open the guidelines/index.html file and remove comment marks around the lines that reference the success criterion and terms you have edited.. 1. Follow the [success criteria format](#user-content-success-criteria-format) below to create the SC content. 1. Save the file and commit the change. NOTE: It is important to also add a suitable 'commit message'. In the comments, reference the issue number from which the proposal was developed starting with a hash, e.g., `#1`. -1. When the success criterion is ready for Working Group review, inform the chairs. Once the proposal has been accepted by the Working Group, the editors will merge the working branch into the master branch, which puts it in the editors' draft and eventual Technical Report publication. +1. When the success criterion is ready for Working Group review, inform the chairs. Once the proposal has been accepted by the Working Group, the editors will merge the working branch into the main branch, which puts it in the editors' draft and eventual Technical Report publication. ### Success Criteria Format @@ -96,8 +96,8 @@ If the link text has a different form from the canonical term, e.g., "web pages" There is one Understanding file per success criterion, plus an index: -* understanding/index.html - index page, need to uncomment or add a reference to individual Understanding pages as they are made available -* understanding//*.html - files for each understanding page, named the same as the success criterion file in the guidelines +* `understanding/index.html` - index page, need to uncomment or add a reference to individual Understanding pages as they are made available +* `understanding/{version}/*.html` - files for each understanding page, named the same as the success criterion file in the guidelines Files are populated with a template that provides the expected structure. Leave the template structure in place, and add content as appropriate within the sections. Elements with class="instructions" provide guidance about what content to include in that section; you can remove those elements if you want but don't have to. The template for examples proposes either a bullet list or a series of sub-sections, choose one of those approaches and remove the other from the template. The template for techniques includes sub-sections for "situations", remove that wrapper section if not needed. @@ -136,10 +136,11 @@ Each new technique should be created in a new branch. Set-up of the branch and f ```Shell bash create-techniques.sh "" ``` -\<technology> is the technology directory for the technique -\<filename> is the temporary filename (without extension) for the technique -\<type> is "technique" or "failure" -\<title> is the title of the technique, enclosed in quotes and escaping special characters with \\ + +* `<technology>` is the technology directory for the technique +* `<filename>` is the temporary filename (without extension) for the technique +* `<type>` is "technique" or "failure" +* `<title>` is the title of the technique, enclosed in quotes and escaping special characters with \\ This automates the following steps: @@ -151,7 +152,7 @@ This automates the following steps: Once a technique branch and file is set up, populate the content and request review: * Populate the template with appropriate content, using other techniques as examples for code formatting choices. Keep the existing structural sections from the template in place. -* When the technique is ready for review, make a pull request into master. +* When the technique is ready for review, make a pull request into the main branch. * If you wish to reference the draft technique from an Understanding document, use the technique's rawgit URI. * After a technique is approved, the chairs will assign it an ID and update links to it in the Undestanding documents. @@ -196,8 +197,8 @@ To create a working example: * Create a directory for the example inside the working examples directory, using the semantic name for the example minus the prefix used in the branch name, e.g., `working-examples/alt-attribute/`. * If the primary example is HTML, name the file `index.html`. Otherwise, create a suitable file name. * Refer to resources shared among multiple examples using relative links, e.g., `../css/example.css`. Place other resources in the same directory as the main example, e.g., `working-examples/alt-attribute/css/alt.css`. -* Reference working examples from techniques using the rawgit URI to the example in its development branch, e.g., `https://rawgit.com/w3c/wcag/master/working-examples/alt-attribute/`. Editors will update links when examples are approved. -* When the example is complete and functional, submit a pull request into the master branch. +* Reference working examples from techniques using the rawgit URI to the example in its development branch, e.g., `https://rawgit.com/w3c/wcag/main/working-examples/alt-attribute/`. Editors will update links when examples are approved. +* When the example is complete and functional, submit a pull request into the main branch. ## Translations