generate inputs-outputs doc

[2bndy5]

Does the same thing as #210 without maligning action.yml

[2bndy5]

I added some changes to the python scripts in docs/ that will emit warning/error annotations about differences in action.yml vs docs/action.yml. As stated in f94df13 commit message:

This is just some future proofing.
The GH warning-annotations will notify new contributions that certain fields are missing.

In a way, this kind of lints action.yml and docs/action.yml (specifically for our usage).

---

New IO contributions to the action.yml (like in #213) will see an annotation saying docs/action.yml needs updating. For those that can't see our drafted releases, they can simply add latest as the minimum-version:

# in docs/action.yml

inputs:
  # ...
  jobs:
    minimum-version: latest

And we can adjust it from main before deploying the release.

[github-actions]

Cpp-Linter Report ⚠️

Some files did not pass the configured checks!

clang-format reports: 2 file(s) not formatted

• docs/examples/demo/demo.cpp
• docs/examples/demo/demo.hpp

clang-tidy reports: 7 concern(s)

• docs/examples/demo/demo.cpp:3:10: warning: [modernize-deprecated-headers]

  inclusion of deprecated C++ header 'stdio.h'; consider using 'cstdio' instead

  #include <stdio.h>
           ^~~~~~~~~
           <cstdio>

• docs/examples/demo/demo.cpp:8:5: warning: [modernize-use-trailing-return-type]

  use a trailing return type for this function

  int main(){
  ~~~ ^
  auto       -> int

• docs/examples/demo/demo.cpp:10:13: warning: [readability-braces-around-statements]

  statement should be inside braces

      for (;;) break;
              ^
               {

• docs/examples/demo/demo.cpp:13:5: warning: [cppcoreguidelines-pro-type-vararg]

  do not call c-style vararg functions

      printf("Hello world!\n");
      ^

• docs/examples/demo/demo.hpp:6:11: warning: [modernize-use-default-member-init]

  use default member initializer for 'useless'

      char* useless;
            ^
                   {"\0"}

• docs/examples/demo/demo.hpp:7:9: warning: [modernize-use-default-member-init]

  use default member initializer for 'numb'

      int numb;
          ^
              {0}

• docs/examples/demo/demo.hpp:11:11: warning: [modernize-use-trailing-return-type]

  use a trailing return type for this function

      void *not_useful(char *str){useless = str;}
      ~~~~~~^
      auto                        -> void *

Have any feedback or feature suggestions? Share it here.

[2bndy5]

I see the updated test CI had no problems with the changes in this branch 🎉