Providing the Documentation

Let's learn how to generate automatic documentation.

We'll cover the following

Automatic documentation generation
Not-as-technical documents of professional project

The final element of a professional project is, of course, the documentation. It comes in two categories:

Technical documentation (interfaces, designs, classes, and files)
General documentation (all other not-as-technical documents)

We saw that CMake could generate many technical documents automatically using Doxygen.

Automatic documentation generation

A thing to mention: some projects generate documentation during the build stage and package it with the rest of the project. It's a matter of preference. For this project, we have decided not to do so. We might have a good reason to choose otherwise (such as hosting the documentation online).

The figure shows the overview of the execution flow that is used in this process:

Get hands-on with 1400+ tech skills courses.

Introduction to the Course

First Steps with CMake

The CMake Language

Setting Up Our First CMake Project

Working with Targets

Compiling C++ Sources with CMake

Linking with CMake

Modern CMake for C++ Exam 1

Managing Dependencies with CMake

Testing Frameworks

Program Analysis Tools

Generating Documentation

Installing and Packaging

Creating Our Professional Project

Conclusion

Appendix

Providing the Documentation

Automatic documentation generation