feat: auto generated docs and refine makefile

[dkooll]

Description

This PR updates documentation and refines the makefile...

PR Checklist

• I have checked if my changes close any open issues. If so please include appropriate closing keywords below.
• I have performed a self-review of my own code
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• Any dependent changes have been merged and published in downstream modules

This is a (please select all that apply):

• Documentation
• Bug Fix
• New Feature (ie adding a service, resource, or data source)
• Enhancement
• Breaking change (not backwards compatible with previous releases)