diff --git a/README.md b/README.md index bc2a5c00..100f4b70 100644 --- a/README.md +++ b/README.md @@ -56,6 +56,14 @@ To build the docker image run: `docker build -t IMAGE_NAME .` +## Generating the API Docs + +1. Run the Test Suite using the `docs` maven profile. This should generate a `swagger.json` file in the target folder of the `scb-engine` module. +2. Run the `swagger2markup:convertSwagger2markup` plugin. This should generate a file located `docs/api-doc.md` in the target folder of the `scb-engine module. +3. Copy the `api-doc.md` file to the user guide of the [secureCodeBox](https://github.com/secureCodeBox/secureCodeBox) repository. +4. Re Add the first disclaimer paragraph pointing the users to the dynamic swagger docs of their engine. This has to be added by hand as it is not included in the export. +5. (Optional) Reformat the generated markdown file with prettier to improve the generated markdown output. + # Guidelines & Standards Well boring yes - but please read our [guidelines and naming standards][scb-developer-guidelines]. diff --git a/scb-engine/pom.xml b/scb-engine/pom.xml index ca4e7ac8..625106a3 100644 --- a/scb-engine/pom.xml +++ b/scb-engine/pom.xml @@ -236,11 +236,29 @@ docs + + + + jcenter-snapshots + jcenter + http://oss.jfrog.org/artifactory/oss-snapshot-local/ + + + jcenter-releases + jcenter + http://jcenter.bintray.com + + false + + + + io.github.swagger2markup swagger2markup-maven-plugin + 1.3.7 ${project.build.directory}/swagger.json