Docdeployer

Usage:

steps:
  - name: swagger-doc
    image: hub.codefirst.iut.uca.fr/thomas.bellembois/codefirst-docdeployer
    commands:
      - /entrypoint.sh <arguments>

entrypoint.sh

This command generates the documentation and deploys it on your CodeDoc space

arguments

• -l --loc [dir] location of the documentation sources root - required
• -t --type [docusaurus|doxygen|swagger] type of documentation generator to use. - required
• -d --dest [dir] path to where to put the documentation outputs in your repository's CodeDoc space - optional !! cannot be absolute !!

Note !
For swagger and doxygen, you have to pass the configuration file instead of a directory

usage examples :

/entrypoint.sh -l ./documentation/api/api-swagger.yml -t swagger -d api_documentation
/entrypoint.sh -l ./documentation/app -t docusaurus -d application_documentation
/entrypoint.sh -l ./src/Doxyfile -t doxygen -d sourcecode_documentation 

How to add custom documentation generator ?