create-docs-pr.step

assemble-single-spec-file:
  description: Assembles a single YAML spec file from partial files
  command: node swagger-spec-assembler.js > api-spec.yaml

create-documentation-pull-request:
  description: Create a PR against the documentation repository
  command: 
    export GIT_BRANCH=update-from-specs-`date +%Y-%m-%-d-%H-%M`
     && git clone git@git.mydomain.com:MyService/documentation.git
     && cd documentation
     && git branch $GIT_BRANCH
     && git checkout $GIT_BRANCH
     && cp ../api-spec.yaml api-docs/api-spec.yaml
     && git add -u
     && git commit -m "auto-generated API documentation"
     && git push origin $GIT_BRANCH