This is an explanation of the repository's file structure:

• C++ source files:
  • include/your-project/your-project.hpp is the main C++ header that declares the interface of your library.
  • src/your-project.cpp is the main file that implements this library.
  • app/your-project_app.cpp is an executable that uses the library. This can e.g. be used to provide a command line interface for your project.
  • tests/your-project_t.cpp contains the unit tests for the library. The unit tests are written using Catch2. For further reading on what can be achieved with Catch2, we recommend their tutorial.
• CMake build system files
  • CMakeLists.txt describes the CMake configuration script. You can find such files in many directories. When CMake runs, the CMakeLists.txt from the top-level directory executes top to bottom. Whenever a command add_subdirectory(<dir>) is executed, the CMakeLists.txt file from the directory <dir> is immediately executed. A comprehensive reference of CMake's capabilities can be found in the official CMake docs. A well-written, opinionated book for beginners and experts is Modern CMake.
• Documentation configuration files
  • The Doxygen documentation is configured directly from doc/CMakeLists.txt. To further configure the build, you can check the Doxygen Configuration Manual for available options and add them with set(DOXYGEN_<param> <value>) before the call to doxygen_add_docs.
  • doc/index.rst contains the actual text of the Sphinx documentation. It is written in reStructuredText, which is described in the Sphinx documentation.
  • doc/conf.py configures the Sphinx documentation that is build for readthedocs. The file contains the default configuration of Sphinx that can be adapted according to their Configuration Guide. Additionally, the file contains build logic for readthedocs that integrates Doxygen output through breathe. For information on what is possible with breathe, check the Breathe documentation.
  • doc/requirements-rtd.txt collect a list of dependencies that need to be installed on the Readthedocs build servers.
• Configuration for CI/Code analysis/Documentation services
  • .github/workflows/ci.yml describes the Github Workflow for Continuous integration. For further reading on workflow files, we recommend the introduction into Github Actions and the reference of available options.
  • .readthedocs.yml configures the documentation build process at ReadTheDocs. To customize your build, you can have a look at the available options.
  • codecov.yml configures the coverage checking from codecov.io. The provided file is the default configuration plus suitable exclusions. For more options, check their configuration reference.
• Markdown files with meta information on the project. Markdown is a good language for these files, as it is easy to write and rendered into something beautiful by your git repository hosting provider.
  • README.md is the file that users will typically see first when discovering your project.
  • COPYING.md provides a list of copyright holders.
  • CITATION.cff provides citation metadata so others know how to reference your project in publications.
  • LICENSE.md contains the license you selected.
  • TODO.md contains a list of TODOs for completing the setup of this software project. Following the instructions in that file will give you a fully functional repository with a lot of integration into useful web services activated and running.
  • FILESTRUCTURE.md describes the generated files. Feel free to remove this from the repository if you do not need it.
• Other files
  • .gitignore contains a default selection of files to omit from version control.