Add workflow to validate and update docs & doc comments

[LasmarKhalifa]

To avoid doc drift, we should have a workflow that verifies each doc and each doc comment for correctness and creates PRs for the ones that need modifications.

[LasmarKhalifa]

This could be either a single workflow, or multiple workflows that each do specific tasks (i.e. one workflow for doc comments and one for docs).

We should also have the ability to either analyze the entire code base or a single file/directory.

[hiSandog]

The workflow should separate mechanically verifiable drift from subjective documentation review. Code snippets, referenced constants/signatures, links, and generated CLI output can be checked deterministically; prose updates should produce a scoped report/draft that a maintainer approves rather than automatically opening many speculative PRs. Per-file mode plus a changed-API detector would make the workflow practical in CI without repeatedly analyzing the entire repository.