Requirements this Software aims to fulfill:#
Generate documentation#
Generate documentation using the Python documentation Generator Sphinx. The Generated files should be html files, and unnecessary intermediate or source files should not be included in the documentation.
Generate Apidoc#
Use sphinx-apidoc/autodoc to Generate apidoc sources for automatic documentation of the package generated from the signatures and comments in the package source-files.
Add generated documentation to GitHub#
The generated documentation files should be added to a GitHub branch in a format that can be used with GitHub-Pages. If no such branch exists, one should be created. It should be possible to decide to directly push the generated documentation to the remote, or not.
Work in an isolated workspace#
The generator should be working in an isolated temporary workspace, so no used repository folders get corrupted or unnecessarily cluttered.
Branch selection#
It should be possible to select which branch to generate the documentation from. Generated documentation should include information as to where it was generated from.