Initial Framework for Using Doxygen to Document Public Header Files

[m271828]

Issues:

Resolves P276033715
Resolves P276038464
Addresses P276034041

Description of changes:

Start of moving AWS-LC over to Doxygen for a documentation framework and automatic publication of documentation with each update to main. This creates the initial configuration files, updates the style guide and includes one converted file as an example.

Call-outs:

The documentation itself is not being updated as part of this work, it is being moved to the Doxygen framework. Updating documentation is future work. Doxygen layout has been customized since this is not a C++ project.

Testing:

Doxygen configuration files and symbol linking have been verified correct with local testing, not yet at the stage for testing via GitHub.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and the ISC license.

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 78.22%. Comparing base (989f64c) to head (5f3ec85).

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2908      +/-   ##
==========================================
- Coverage   78.22%   78.22%   -0.01%     
==========================================
  Files         690      690              
  Lines      118745   118745              
  Branches    16679    16680       +1     
==========================================
- Hits        92894    92886       -8     
- Misses      24961    24971      +10     
+ Partials      890      888       -2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.