Operations: Difference between revisions

No edit summary
add documentation summary
Line 2: Line 2:


== Documentation ==
== Documentation ==
'''Free''' means that their should be as little costs as possible to everyone involved. Free to contribute, and free to read. Getting permission to contribute is as simple as asking in the [matrix] space. It's important for our community model that we can talk to and discuss changes that people have made if we need to.
'''Accessible''' documentation isn't just about screen readers. The text should be written so that it is easy to read, and tries to avoid overly-technical explanations with a lot of jargon. Paragraphs should be capped at 5 or so sentences to avoid the "wall of text" effect. Docs should also try to target different skill/knowledge levels. But besides the documentation being accessible, it's important to document how to *make* computers be more accessible. That means testing things like:
* Screen readers
* High-Contrast modes
* Magnification
* Scaling settings
* Clear design
* Good documentation
* Translations
* Low-end hardware
'''Safe''' software focuses not just on privacy and security, though of course those are important, but also things like no user-hostile features. Addictive design patterns for example, are very dangerous for many people. Things like, Infinite scrollers, algorithmic recommendations. It's also important to have guide rails to prevent the user from breaking their system, though of course experienced users should be able to lower them.