Skip to content

Add Documentation Generator Drift Detection #406

Description

@maugauwi-hash

Labels: testing, documentation
Priority: Low
Estimated Time: 1.5 hours

Description:
backend/src/doc_generator.rs and docs/documentation-generation.md generate docs from code, but there's no CI check confirming committed docs (e.g., docs/api-reference.md) are actually up to date with the generator's current output.

Tasks:

  • Add a CI job that regenerates docs and diffs against the committed version
  • Fail the build on drift with a clear message on how to regenerate
  • Add tests for the generator's output stability (deterministic ordering)
  • Document the regeneration workflow in docs/documentation-generation.md

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Stellar WaveIssues in the Stellar wave programdocumentationImprovements or additions to documentationtesting

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions