Skip to content

6. Doxygen Documentation

Edward Hartnett edited this page Apr 30, 2021 · 9 revisions

All Fortran, C, and C++ code in UFS_UTILS shall be documented using doxygen.

All files, modules, module variables, and subprograms must have a doxygen documentation block. All function and subroutine parameters must be documented. All files, modules, and subprograms will identify the author(s).

The presence of doxygen documentation is checked in the Continuous Integration runs. Code cannot be merged without doxygen documentation.

Documentation contents are reviewed as part of code review. Documentation will use proper grammar, complete sentences, and proper capitalization and punctuation.