diff --git a/docs/source/contributing/accessibility-guidelines.md b/docs/source/contributing/accessibility-guidelines.md
index 5119a4b531..e7fa40d334 100644
--- a/docs/source/contributing/accessibility-guidelines.md
+++ b/docs/source/contributing/accessibility-guidelines.md
@@ -9,16 +9,61 @@ myst:
# Accessibility guidelines
-Attention should be paid to improve and maintain accessibility. In documentation, code and filenames you will often see this abbreviated as "a11y".
+Attention should be paid to improve and maintain accessibility, abbreviated as "a11y".
-## Clickable elements that have a symbol or icon and no visible text
-If the symbol or icon is clear enough for sighted users, for instance a big "X" to close a dialog, it will still need a text for screen reader users.
+## Tools
-You can achieve a 'hidden' label by setting the property "aria-label" on the element.
-If available, use the translation machinery available to make the label appear in the correct language.
+Volto developers use several tools to analyze and test the accessibility of their projects.
-Example:
+[`cypress-axe`](https://github.com/component-driven/cypress-axe)
+: Automate accessibility testing with [`axe-core`](https://github.com/dequelabs/axe-core) in [Cypress](https://cypress.io/).
+ See also [axe devTools](https://www.deque.com/axe/devtools/), a tool that helps developers check digital content against accessibility standards.
+
+[IBM Equal Access Accessibility Checker browser extensions](https://www.ibm.com/able/toolkit/tools#develop)
+: Browser extensions that test your code for accessibility issues.
+
+[Accessible Web](https://accessibleweb.com/)
+: A commercial tool that helps teams discover, understand, and remediate web accessibility issues.
+
+[VoiceOver](https://developer.apple.com/documentation/accessibility/voiceover/)
+: A gesture-based screen reader that provides an auditory description of the content onscreen for Apple iOS and macOS devices.
+ See [VoiceOver keyboard shortcuts](https://dequeuniversity.com/screenreaders/voiceover-keyboard-shortcuts) for usage.
+
+[A11Y-Color-Blindness-Empathy-Test](https://vinceumo.github.io/A11Y-Color-Blindness-Empathy-Test/)
+: Help designers and developers to understand color blindness and visual imparity.
+
+[WAI-ARIA - Screen reader compatibility](https://www.powermapper.com/tests/screen-readers/aria/)
+: Shows how different WAI-ARIA attributes behave in commonly used screen readers.
+ The results include two types of tests.
+
+ - Expected to work - these tests show support when accessibility features are used correctly
+ - Expected to fail - these tests show what happens when accessibility features are used incorrectly
+
+
+
+
+
+## Tests
+
+We use [`cypress-axe`](https://github.com/component-driven/cypress-axe) for automated testing of accessibility in Volto via Cypress.
+
+Place accessibility test files in the directory {file}`packages/volto/cypress/tests/core/a11y/`.
+
+Name accessibility tests `[THING] tested for a11y axe violations`.
+
+
+## Common accessibility issues
+
+This section describes common issues that you might need to address while developing for Volto core or an add-on.
+
+
+### Clickable elements that have a symbol or icon and no visible text
+
+If the symbol or icon is clear enough for sighted users—for instance a big "X" to close a dialog—it will still need a text for screen reader users.
+
+You can achieve a "hidden" label by setting the property `aria-label` on the element.
+If available, use the translation machinery to make the label appear in the correct language.
```jsx
```
-## Do not use `` tags without href
+### Do not use `` tags without `href`
+
+If an element has an event listener on it and performs an action, but does not point to a proper URL, use a `