The docs/ directory is designated to contain project documentation.
Documentation for users can be found at https://mediaelch.github.io/mediaelch-doc/. Its source code can be found at https://github.com/mediaelch/mediaelch-doc/.
The contributing folder contains tutorials, guides and some best-practices
for MediaElch. They are useful to developers and maintainers of MediaElch.
See contributing/README.md for the table-of-contents.
It also contains tips & tricks for your development setup.
See "Architecture Design Records" below for design documents.
This project does not contain a Doxyfile as we have a custom CMake
target for this.
# Create Doxygen documentation using CMake
mkdir build && cd $_
cmake ..
make doxygenOur Architecture Design Records (ADR) describe design decision around our architecture but also contains many TODO notes. Our design documents are partially moved there.
There is also https://github.com/mediaelch/mediaelch-dev, which contains some in-progress design documents and ideas. It's a separate repository due to it containing many (large) images that would bloat MediaElch's main repository.
The admin directory contains a few documents that are useful to the
current MediaElch maintainers. They describe how to publish a new
MediaElch version, how to manage Transifex and so on.
It may still be interesting to non-maintainers.
See admin/README.md.