# docs

This folder contains the project documentation in [AsciiDoc][asciidoc] format.
To compile the documents, make sure you have [Ruby][rubydl] and the
dependencies installed by running the `bundle` command in this folder. A
makefile is provided for convenience.

## notes for writers

- "I<sup>2</sup>C" is written as `I^2^C`
- "C++" is written as `{cpp}`

## TODO

- transfer documents
    - [x] project plan
    - [x] requirements
    - [x] research
    - [ ] software design
- xrefs for--
    - [x] tables
    - [x] figures
    - [x] section numbers (headings)
    - [x] requirements
- [x] figures
- [x] citations
- [ ] glossary (w/ cross-references)
- [ ] PDF style

[rubydl]: https://www.ruby-lang.org/en/documentation/installation/
[asciidoc]: https://asciidoc.org/