to build, run `make swagger`; a file named `swagger.json` will be written to the current working directory