design/api/README.md
author ymh <ymh.work@gmail.com>
Wed, 19 Jul 2017 15:57:13 +0200
changeset 119 8ff8e2aee0f9
parent 116 672e3c4bbd0c
permissions -rw-r--r--
add parameter to filter session and note by updated date. Add pagination on sessions and notes. add read only endpoint at root level to list notes

# Generation of API documentation

The documentation use the api blueprint format ([documentation](https://apiblueprint.org)).

[Aglio](https://github.com/danielgtaylor/aglio) is used for rendering the documentation into html.

## install Aglio

```bash
$ npm install
```

### Available commands

- Build the documentation (file metacategory.html)
```bash
$ npm run build
```

This runs the following command:
```bash
$ aglio -i metacategory.apib -o metacategory.html
```

- Watch the documentation.
```bash
$ npm run watch
```

This runs the following command:
```bash
aglio -i metacategory.apib -s
```