The ODK suite contains our most well-known and widely deployed tools. These tools support the most common use cases, are proven at scale, and are compatible with a large ecosystem.
It is currently difficult for both new users of ODK tools and for new contributors to the ODK docs to navigate the documentation. This project will involve reworking the contribution process as well as the documentation structure.
On the contributor side, we have a very thorough guide at https://docs.opendatakit.org/contributing, but it’s overwhelming to newcomers. If someone can’t get started, we have a problem! We’d like to enable contributors to make minor changes to the documentation without having to read an enormous guide and set up a development environment. We are open to changing some of our tooling to make this possible.
The core team that writes much of the documentation is often focused on describing a particular technical feature. We don’t always have a chance to take a step back and ensure that the content is logically ordered and our language is consistent.
Part of this rethinking of the documentation structure will involve developing processes that allows the core team to keep the docs easy to understand and consistent, adding documentation to address existing issues (https://github.com/opendatakit/docs/issues) and filing new issues describing content gaps.