Consider the code in this repo as sample code.
Documentation for the cta-aggregator project
This repo uses slate to allow markdown-driven documentation.
The codebase for the CTA Aggregator is located here: https://github.com/RagtagOpen/cta-aggregator.
This docs site is deployed at https://ragtagopen.github.io/cta-aggregator-docs/.
To run this project locally, install the dependencies and launch the server. To do this.
- In your terminal, at the root of this project, run
bundle install
. - Once the dependencies have been installed, run
bundle exec middleman server
. - In your browser, navigate to
http://localhost:4567
.
There's a deployment script at the root of this project. We do not currently have a way to automate updates to the documentation site. So, after your changes have been accepted and merged into master, you'll need to pull the changes down to your local master branch and then run the deploy script.
- In your terminal, get on your master branch and make sure it's up to date with the remote.
- Run
bash deploy.sh
. - In your browser, navigate here and verify that everyhing looks correct.
- Show examples of what happens when user attempts to create duplicate record
- Show examples of what happens when user attempts to provide malformed request