api-documentation
Adds Doxygen-compatible documentation comments to C++ header files. Use this skill exclusively for adding or improving API documentation in existing header files (*.hpp, *.h). Do NOT create new resource files such as Doxyfile, scripts, or README files.
SKILL.md
| Name | api-documentation |
| Description | Adds Doxygen-compatible documentation comments to C++ header files. Use this skill exclusively for adding or improving API documentation in existing header files (*.hpp, *.h). Do NOT create new resource files such as Doxyfile, scripts, or README files. |
Template C++
A modular C++ project using a component-based architecture, with CMake as the build system and Conan for dependency management.
1. Details
1.1. Prerequisites
-
Distributed version control system for tracking source code changes.
sudo apt install git -
Git extension for managing large files (assets, binaries) outside normal Git history.
sudo apt install git-lfs git lfs install -
Task automation tool to manage build processes and workflows.
sudo apt install make
2. Contribute
CONTRIBUTING.md provides guidens and instructions for contributing to the project.
-
Automated tools that assist in various development tasks such as code generation, testing, and documentation.
-
CLI tool for managing AI agent skills in development projects.
-
Make automation tool that defines and manages tasks to streamline development workflows.
-
Scripts to bootstrap, setup, and teardown a software development workspace with requisites.
-
Consistent development environments using Docker containers.
-
CMake build system configuration and presets for building the project.
-
Conan package manager configuration for managing project dependencies and packages.
-
Unit tests, coverage, and sanitizers for ensuring code quality and reliability.
-
Compiler cache configuration to speed up rebuilds.
-
Semantic-Release automates the release process by analyzing commit messages.
-
Renovate and Dependabot automate dependency updates by creating pull requests.
-
SOPS for managing and encrypting sensitive data such as passwords, API keys, and other secrets.
-
Docker containerization tool to run applications in isolated container environments.
-
Conftest for policy-as-code enforcement.
-
Trivy for security scanning of vulnerabilities, misconfigurations, and compliance issues.
-
Doxygen for generating API documentation from annotated source code.
3. Troubleshoot
3.1. TODO
TODO
4. References
- Sentenz Template DX repository.
- Sentenz Template C++ repository.
- Sentenz Actions repository.
- Sentenz Manager Tools article.
- Sentenz Skills repository.