Uploaded image for project: 'ERM Platform'
  1. ERM Platform
  2. ERM-1985

Publish mod-agreements API documentation on dev.folio.org

    XMLWordPrintable

Details

    • Bienenvolk

    Description

      FOLIO publishes API documentation at https://dev.folio.org/reference/api/

      However, mod-agreements' API documentation is at https://github.com/ostephens/folio-erm-agreements-api-os/ , it is not easy to find (side note: and developers cannot update both the implementation and documentation in a single pull request when working on a feature), and several steps (clone, npm) are needed to convert the raw openapi documentation into the final HTML documentation (see https://github.com/ostephens/folio-erm-agreements-api-os/blob/main/README.md ).

      As of 2023-03-16:

      One option is to move the documentation into the mod-agreements repository and use Jenkins' API documentation deploy feature: https://dev.folio.org/guides/api-lint/#jenkinsfile-for-oas

      Acceptance criteria:

       (This ticket may be split into smaller tasks.)

      TestRail: Results

        Attachments

          Issue Links

            Activity

              People

                ostephens Owen Stephens
                julianladisch Julian Ladisch
                Votes:
                0 Vote for this issue
                Watchers:
                5 Start watching this issue

                Dates

                  Created:
                  Updated:

                  TestRail: Runs

                    TestRail: Cases