jekyll-template
This jekyll template repository will be used to generate documentation for all the projects.
Benefits of using jekyll template are:
- Documentation look and feel of all the projects will be same.
- Templates will also be version controlled
- Any Custom plugin created for Jekyll will be available for all the projects to use.
Steps how documentation will be created.
- During Jenkins Release build, once the release build is complete, jekyll-template directory will be cloned in a temp directory.
- From the project that is released, documents will be copied into cloned repository.
- jekyll build will be run
- _site directory generated by jekyll will be pushed to Amazon S3 so that documentation can be accessed by public URL.
Pre-requisites
- Ruby, RubyGem, Jekyll is installed on Jenkins machine (gem install jekyll --no-ri --no-rdoc)
- DNS Name to S3 Bucket mapping is already done (if required)