This repository contains the official source of the CF metadata conventions.
The source files are built into HTML automatically when changes are merged into this repository.
The latest build of the specfication is held in the gh-pages branch and can be seen at: http://cfconventions.org/cf-conventions/cf-conventions.html.
For the official web site please visit: http://cfconventions.org/, and the corresponding GitHub organisation: https://github.com/cf-convention.
To convert the AsciiDoc files into the resulting HTML file:
- Ensure you have Ruby installed (e.g.
sudo apt-get install ruby) - Ensure you have a recent version of Asciidoctor installed (e.g.
gem install asciidoctor) - Get hold of the AsciiDoc files in this repo (e.g.
git clone [email protected]:cf-metadata/cf-conventions.git) - Build the HTML:
asciidoctor cf-conventions.adoc
See the GitHub help pages and plethora of other git/GitHub guides for more details on how to work with repos, forks, pull requests, etc.
Whenever a pull request is merged, a travis-ci build generates the latest specification draft and adds it to the gh-pages branch here. The gh-pages branch is deployed to github pages at the following documents:
- http://cfconventions.org/cf-conventions/cf-conventions.html
- http://cfconventions.org/cf-conventions/cf-conventions.pdf
- http://cfconventions.org/cf-conventions/conformance.html
- http://cfconventions.org/cf-conventions/conformance.pdf
These documents are linked in the cf-conventions web site. source here which is published to: http://cfconventions.org/. The latest spec documents are linked from those web pages here: http://cfconventions.org/latest.html.