Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
docs
.codeclimate.yml
.gitignore set up mkdocs Jan 15, 2017
.markdown.style.rb
.mdlrc
Dockerfile
README.md Fix build (#93) Oct 29, 2018
docker-compose.yml add graphviz for network diagram (#74) Jun 7, 2017
mkdocs.yml
requirements.txt

README.md

Docs

Documentation Status Code Climate CircleCI

Documentation for Redbrick

Available at docs.redbrick.dcu.ie and at the readthedocs mirror The readthedocs mirror is automatically deployed on commit to master. The docs site is a scheduled cron job on halfpint that git pull && mkdics build once an hour to up date the docs.

The docs are built using mkdocs. To bring up a local server with a copy of the docs just run

docker-compose up docs

To build the docs just run

docker-compose run --rm docs mkdocs build

Testing locally

When you make a change make sure it works by building it locally. Run

docker-compose run --rm docs mkdocs build
docker-compose run --rm test

This will test the docs build and if there are any dead links in them