Skip to content
Dark Blue ("Project Chipmunk")
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.
app
bin
config
db
docs
lib
log
public
spec
vendor
.envrc
.gitignore
.rspec
.rubocop.yml
.rubocop_todo.yml
.simplecov
.travis.yml
.yardopts
Gemfile
Gemfile.lock
README.md
Rakefile
config.ru

README.md

Build Status Coverage Status API Docs Documentation Status

Dark Blue ("Project Chipmunk")

A Preservation-Focused Dark Repository for the University of Michigan

The documentation can be found here

Building Documentation Locally

RubyDoc.info

RubyDoc.info is an external host for javadoc-style documentation of your project's modules, classes, and methods. It uses yard to build out the documentation directly from your source code. It works minimally on ruby codebases out of the box, and offers a comprehensive host of directives that can used in source code comments to further improve the product.

RubyDoc.info updates automatically. You can compile and view the documentation locally by running bin/yard serve, then viewing it in a browser.

ReadTheDocs

ReadTheDocs is a documentation host for those docs that are not specifically source code annotations. Typically, this will include high-level descriptions, workflows, reasoning, and those things that one usually finds in a README.

ReadTheDocs uses sphinx to build the documentation, and will do so automatically. You can compile and view the documentation locally. Note that this will require python to be installed; the version from your package manager is sufficient.

PlantUML Graphs

Both ReadTheDocs and the local sphinx instance can automatically draw graphs from text using PlantUML. Note that to build this locally, the command plantuml needs to be on your path.

Describing HTTP

This repository is configured with the addon httpdomain which can be used to effectively describe RESTful or other HTTP endpoints and APIs.

Build!

cd docs
pip install -r requirements.txt
make auto
# Then view it with a browser
You can’t perform that action at this time.