Merge branch 'main' into deprecations-from-40613-feature-pr

Author: HLeithner

.drone.yml

@@ -10,6 +10,7 @@ steps:
     commands:
       - npm install
       - npm run build
+      - mv webserver/.htaccess build
 
   - name: deployment
     image: joomlaprojects/docker-images:packager
@@ -47,6 +48,6 @@ steps:
 
 ---
 kind: signature
-hmac: 3d1303abd175ffda3aec141c6ea71d541f50f3c3e0752a68330fde5560386a58
+hmac: ae910acaafbf7e06bea4e33c509dbabe08e1edaba7f175d91db4a880030c7cc4
 
 ...

docs/accessibility/further-reading.md

@@ -1,12 +1,45 @@
 ---
 sidebar_position: 7
 ---
+
 Further Reading
-===========
-Additional accessibility resources can go here.
+===============
+
+Additional accessibility resources to help you learn more about accessibility and how to make your website more accessible.
+
+## General
+
+- [UN Convention on the Rights of Persons with Disabilities](https://www.un.org/development/desa/disabilities/convention-on-the-rights-of-persons-with-disabilities/article-9-accessibility.html)
+- [Accessibility Fundamentals](https://www.w3.org/WAI/fundamentals)
+- [How to meet WCAG](https://www.w3.org/WAI/WCAG22/quickref/)
+- [Inclusive Design Principles](https://inclusivedesignprinciples.info/)
+- [Accessibility Myths](https://a11ymyths.com/)
+
+## Blogs
+- [Sara Soueidan](https://www.sarasoueidan.com/blog/)
+- [Eric Eggert](https://yatil.net/blog)
+
+## Alternative text for images
+- [Writing Alt Text for Data Visualization](https://medium.com/nightingale/writing-alt-text-for-data-visualization-2a218ef43f81)
+- [Write helpful Alt Text to describe images](https://accessibility.huit.harvard.edu/describe-content-images)
+- [How to Write Alt Text for Images: Best Practices & Examples](https://kdesign.co/blog/how-to-write-alt-text/)
+- [Are you making these five mistakes when writing alt text?](https://www.a11yproject.com/posts/are-you-making-these-five-mistakes-when-writing-alt-text/)
 
-:::caution TODO
+## Browser Tools
+- [Lighthouse (included Chrome)](https://developer.chrome.com/docs/lighthouse/)
+- [Wave](https://wave.webaim.org/)
+- [axe DevTools](https://www.deque.com/axe/devtools/)
+- [ANDI](https://www.ssa.gov/accessibility/andi/help/install.html)
+- [Landmarks](http://matatk.agrip.org.uk/landmarks/)
+- [IBM Equal Access Accessibility Checker](https://www.ibm.com/able/toolkit/tools/#develop)
 
-This page is unfinished, please use the **Edit this Page** link at the bottom of this page to help make it more useful.
+## Screenreader
+- [NDVA (Windows)](https://www.nvaccess.org/)
+- [VoiceOver (MacOS)](https://support.apple.com/de-at/guide/voiceover/welcome/mac)
+- [Setting up a screen reader testing environment on your computer](https://www.sarasoueidan.com/blog/testing-environment-setup/)
 
-:::
+## Checklisten & Co.
+- [The A11y Project](https://www.a11yproject.com/checklist/)
+- [Webflow](https://webflow.com/accessibility/checklist)
+- [Deque University](https://dequeuniversity.com/checklists/web/)
+- [IAAP](https://www.accessibilityassociation.org/s/certification)

docs/accessibility/reporting-issues.md

@@ -1,12 +1,9 @@
 ---
 sidebar_position: 6
 ---
-Reporting Errors
-===========
-How do people report accessibility issues in the CMS or template to us?
 
-:::caution TODO
+Reporting Errors
+================
 
-This page is unfinished, please use the **Edit this Page** link at the bottom of this page to help make it more useful.
+You can report accessibility issues in the CMS (using the standard Cassiopeia template) sending us an email to: [[email protected]](mailto:[email protected])
 
-:::

docs/building-extensions/components/component-examples/_assets/component-example-ajax.png

@@ -5,17 +5,15 @@ title: Ajax demo component
 Ajaxdemo Component
 ==================
 
-This is an example component which you can download from [com_ajaxdemo](https://github.com/joomla/manual-examples/tree/main/component-ajaxdemo).
+This example component demonstrates the use of Ajax to interact with the server without requiring a page load. For further background see the General Concepts section on [Ajax and JsonResponse](../../../general-concepts/javascript/ajax.md).
 
-It demonstrates the use of Ajax within a Joomla component; 
-for further background see the section [Ajax and JsonResponse](../../../general-concepts/javascript/ajax.md).
+The component can be easily adapted to demonstrate the use of [com_ajax](../../../general-concepts/javascript/com-ajax.md) for plugins and templates. Simply change `url` in media/js/divide.js to point to com_ajax instead of com_ajaxdemo and set the other required URL parameters.
 
-It can be easily adapted to demonstrate the use of [com_ajax](../../../general-concepts/javascript/com-ajax.md) for plugins and templates; 
-simply change the url in media/js/divide.js to point to com_ajax instead of com_ajaxdemo, and set the other required URL parameters.
+An installable ZIP file can be obtained via [DownGit](https://downgit.github.io/#/home?url=https://github.com/joomla/manual-examples/tree/main/component-ajaxdemo/com_ajaxdemo). After installation go to `<your domain>/index.php?option=com_ajaxdemo` to run it in your Joomla instance.
 
-Once you have downloaded the source, zip up the com_ajaxdemo directory and install the component.
+The following screenshot shows the example form with some data added:
 
-Then go to `<your domain>/index.php?option=com_ajaxdemo` to run it on your Joomla instance.
+![example form with added data](_assets/component-example-ajax.png)
 
 The component displays a form to capture two numbers A and B, and a button to calculate A/B. 
 The division is performed by an Ajax call to the server, and if B is zero then an exception is raised.

docs/building-extensions/components/component-examples/_assets/component-example-form.png

@@ -6,13 +6,7 @@ title: Example Form Component
 Example Form Component
 ======================
 
-This is an example component which you can download from [com_exampleform](https://github.com/joomla/manual-examples/tree/main/component-exampleform).
-
-Once you have downloaded the source, zip up the com_exampleform directory and install the component.
-
-Then go to `<your domain>/index.php?option=com_exampleform` to run it on your Joomla instance.
-
-It is an MVC component which demonstrates the following:
+This example MVC component demonstrates the following aspects of form manipulation:
 
 - using [Joomla Forms](../../../general-concepts/forms/how-forms-work.md) to capture data in a form
 - using several of the [standard form fields](../../../general-concepts/forms-fields/standard-fields/index.md)
@@ -21,9 +15,13 @@ It is an MVC component which demonstrates the following:
 - writing a [custom client-side validation rule](../../../general-concepts/forms/client-side-validation.md)
 - writing a [custom form filter](../../../general-concepts/forms-fields/standard-form-field-attributes.md#filter)
 
-You can easily adapt it to experiment with other standard fields, simply by including the standard field in the form XML file.
+An installable ZIP file can be obtained via [DownGit](https://downgit.github.io/#/home?url=https://github.com/joomla/manual-examples/tree/main/component-exampleform/com_exampleform). After installation go to `<your domain>/index.php?option=com_exampleform` to run it in your Joomla instance.
+
+The following screenshot shows the example form with some data added:
+
+![example form with added data](_assets/component-example-form.png)
 
-There are comments throughout the code to help you understand it, and brief summaries of the main source files are provided below.
+Brief summaries of the main source files are provided below. There are additional explanatory comments throughout the code.
 
 ## Administrator service provider
 
@@ -125,9 +123,9 @@ Path: components/com_exampleform/src/View/ExampleformReturn/HtmlView.php
 
 This simply has a function to accept the data from the Controller, which it stores locally.
 
-## Site ExampleformReturn tmpl file
+## Site exampleformreturn tmpl file
 
-Path: components/com_exampleform/tmpl/exampleformReturn/default.php
+Path: components/com_exampleform/tmpl/exampleformreturn/default.php
 
 This simply outputs the raw and filtered data which was passed to the view.
 

docs/building-extensions/components/component-examples/_assets/manual-examples-in-vscode.png

@@ -6,4 +6,29 @@ title: Example Components
 Component Examples
 ==================
 
-In this section you can find worked examples of components of various types.
+This section contains worked examples of components of various types. To obtain the examples source code to inspect or install you may clone the manual-examples repository or download an installable zip file for an individual example.
+
+## To clone the repository
+
+Navigate to a location on your development computer where you can keep multiple repositories. You might have a folder named `repos` or `git` or something else. In a terminal window use the following command:
+
+```sh
+git clone https://github.com/joomla/manual-examples.git
+```
+
+This takes no time at all and will give you a clone of the manual-examples repository that is very easy to inspect in an IDE. Here is an example screenshot of a clone open in VSCode:
+
+![screenshot of manual examples folder in vscode](_assets/manual-examples-in-vscode.png)
+
+To create an installable zip file, compress the subfolder containing the example code, such as the com_exampleform folder.
+
+## To download an installable zip
+
+1. Go to the [manual-examples repository](https://github.com/joomla/manual-examples) on GitHub.
+2. Select the example you wish to download, for example component-exampleform.
+3. Select the subfolder containing the example, com_exampleform.
+4. Copy the URL from the browser URL bar.
+5. Go to a download utility site such as [DownGit](https://downgit.github.io/#/home).
+6. Paste the URL copied in step 4 into the form.
+7. Select the Download button.
+8. Save the downloaded zip file. This can be installed in a Joomla instance or expanded to inspect with an IDE.