Document the headings anchor script in the design system

Author: NicolaSaunders

design-system-config.php

@@ -17,7 +17,7 @@
         'Styles'                => '/styles/',
         'Layouts'               => '/layouts/',
         'Components'            => '/components/',
-        'Third party plugins'   => '/third-party-plugins/',
+        'Scripts'  												 => '/scripts/',
         'Templates'             => '/templates/',
     ],
     'templates_path'    => 'design-system-templates',

design-system-templates/design-system/footer-text.html.twig

@@ -1,2 +1,2 @@
-<p>Copyright © 2023 W3C - generated {{ date|date("d M Y, H:i:s e") }}</p>
+<p>Copyright © {{ date|date("Y") }} W3C - generated {{ date|date("d M Y, H:i:s e") }}</p>
 <p>Feedback is welcome and can be submitted as a <a href="https://github.com/w3c/w3c-website/issues">GitHub issue</a>.</p>

docs/README.md

@@ -25,7 +25,7 @@ More generic and wide-reaching styles sit within the lower numbered levels, with
 - **40-layouts:**<br> heavily influenced by [Every Layout](https://every-layout.dev/), these are the styles for the basic layout types, which can be combined and customised to make a variety of components and templates - [more about layouts](layouts/README.md)
 - **50-core-components:**<br> the basic components available for use, un-enhanced by JavaScript - [more about components](components/README.md)
 - **60-advanced-components:**<br> components that are enhanced in some way with JavaScript - [more about components](components/README.md)
-- **70-third-party-plugins:**<br> any functionality that comes from external sources - [more about third-party plugins](third-party-plugins/README.md)
+- **70-third-party-plugins:**<br> styles for components/functionality from sources external to the design system, typically via scripts. They may include some customisations specifically required to fit in with the design system.
 - **80-templates:**<br> styles required for specific page templates and/or content types - [more about templates](templates/README.md)
 - **90-utilities:**<br> overrides or helper classes - [more about utilities](styles/utilities.md)
 

docs/scripts/README.md

@@ -0,0 +1,5 @@
+# Scripts
+
+Documenting functionality that is added via scripts.
+
+For sources that are external to the design system, there may be some customisations specifically required.

docs/scripts/heading-anchors.md

@@ -0,0 +1,11 @@
+# Heading anchors
+
+This script is part of `main.js`/`main.min.js`. To help linking to specific parts of pages, this script automatically creates and appends a visible anchor link to any H2-H6 heading within the `<main>` element, with the following exclusions:
+
+- where the heading is a child of a `<nav>` element
+- where the heading carries the attribute `data-anchor="no"`
+- where a heading has an ancestor carrying the attribute `data-anchor="no"`
+
+If a heading already has an `id` attribute, this is used when creating the `href` for the `<a>`. Otherwise, the script parses the text content of the heading to create both the heading `id` and the anchor `href`.
+
+To override the default behaviour of the script and prevent the addition of anchor links to headings, modify the HTML markup to apply the `data-anchor="no"` attribute to an individual heading (or to a parent container, if targeting a group of headings).