• Sheltac
    link
    fedilink
    arrow-up
    28
    ·
    1 year ago

    Because things keep changing and no one ever updates any docs or guides.

    • BlueKey@kbin.socialOP
      link
      fedilink
      arrow-up
      17
      ·
      1 year ago

      It would be nice to have a kind of central hub where all the lastest resources are listed.
      I could be updated by the community.

      Well… one can dream.

    • 2ez@lemmy.beyondcombustion.net
      link
      fedilink
      English
      arrow-up
      1
      ·
      1 year ago

      If using docstrings/docblocks to generate SDK documentation, adding something like an OPA policy to validate their existence and semantic structure could help with coverage. Then we have the issue of accuracy, and that needs humans or AI to weigh in. I have a feeling test-driven development would make this process smoother.

      You could also add git hooks to facilitate accountability / run the policies.