Skip to content

Comments

Feature/doxygen generation#14

Merged
JacobBorden merged 3 commits intodevelopmentfrom
feature/doxygen-generation
May 31, 2025
Merged

Feature/doxygen generation#14
JacobBorden merged 3 commits intodevelopmentfrom
feature/doxygen-generation

Conversation

@JacobBorden
Copy link
Owner

No description provided.

This commit introduces automated Doxygen HTML documentation generation.

Key changes:
- Added a `Doxyfile` to the root of the repository, configured to scan `src` and `include` directories and output HTML documentation to `docs/doxygen/html`.
- Modified the `.github/workflows/analysis.yml` workflow:
    - Added a step to install Doxygen using `apt-get`.
    - Added a step to run Doxygen using the `Doxyfile`.
    - Added a step to upload the generated HTML documentation as a build artifact named `doxygen-html-docs`.

This will ensure that documentation is generated automatically with each run of the analysis workflow, providing up-to-date documentation for the project.
The previous version v3 was causing issues in the GitHub Actions workflow.
Updated to v4 to resolve the action download error.
This commit addresses issues found during Doxygen generation:

- Upgraded `Doxyfile` to version 1.9.8 using `doxygen -u` to remove obsolete tags and ensure compatibility.
- Modified the `.github/workflows/analysis.yml` workflow to add a step that creates the `docs/doxygen` output directory before Doxygen is run. This resolves the "Output directory does not exist" error.
@JacobBorden JacobBorden merged commit b4035fd into development May 31, 2025
6 checks passed
@JacobBorden JacobBorden deleted the feature/doxygen-generation branch May 31, 2025 13:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant