swag-analytics/README.md
Andrew Mayorov f30e1f8e93
Clean up specification
And drop proprietary CI stuff.
2022-03-14 20:08:45 +03:00

22 lines
954 B
Markdown

# Valitydev Analytics API Specification
> Deprecated. See instead https://github.com/valitydev/swag-anapi-v2.
## Working on specification
### Install
1. Install [Node JS](https://nodejs.org/)
2. Clone repo and `cd`
+ Run `npm install`
### Usage
1. Run `npm start`
2. Checkout console output to see where local server is started. You can use all [links](#links) (except `preview`) by replacing upstream url with url from the message: `Server started <url>`
3. Make changes using your favorite editor or `swagger-editor` (look for URL in console output)
4. All changes are immediately propagated to your local server, moreover all documentation pages will be automagically refreshed in a browser after each change
**TIP:** you can open `swagger-editor`, documentation and `swagger-ui` in parallel
5. Once you finish with the changes you can run tests using: `npm test`
6. Share you changes with the rest of the world by pushing to GitHub :smile: