# Contributing

While up to version 1.0.0 ally.js has been developed primarily by only one person, the intention is to get more people aboard. If there is anything about ally.js you'd like to improve, open an issue so we can discuss how you might approach that goal. We've created some docs and rules to give contributors some guidance. Don't worry if you don't understand every single piece of our fuzzy puzzle, we'll help you in any way we can.

ally.js strives to be a general purpose helper library for accessibility concerns. As such, contributions should be applicable to virtually any project and refrain from being overly specific. GOALS.md describes the possible future of the project. If you have any expertise or experience to share for those topics, please open an issue to discuss.

ally.js is not only about the library code. All the concepts covered by ally.js need to be explained in such a way that people new to accessibility understand what is going on. To make that happen, you can help improve our documentation or write a tutorial.

# Who can contribute?

Anyone can join. Everything is done on github in the open. Everything is up for discussion.

• You specialize in accessibility, but aren't an expert with the JavaScripts? No worries, be the brains, we'll be your code monkeys. See issues tagged with question or discussion.
• You specialize in JavaScript, but aren't experienced with that accessibility thing? No worries, I'm sure there's plenty to optimize and refactor and test and so on. You'll probably find something to improve in ./src or ./test or issues tagged with improve.
• You specialize in writing things but your accessibility is about as rusty as your JavaScript? Have a look at the docs, I'm sure they can be translated to actual, proper English. You'll likely find something in ./docs or issues tagged with website or documentation.
• You specialize in the build pipeline? Issues tagged with build might be your thing.
• You specialize in a framework or library and would like to integrate ally.js? See the issues tagged with integration or open a new issue to discuss your approach.

# Documentation for contributors

• Contribution guide on Github
• Building ally.js
• Documenting ally.js
• Testing ally.js
• Releasing ally.js

# Acknowledgements

While the project and most of its resources were created by Rodney Rehm, the following people had substantial impact on ally.js:

• Alice Boxhall
• Heydon Pickering
• Marco Zehe
• Marcy Sutton
• Patrick H Lauke
• Steve Faulkner
• … and probably a few more