Skip to content

Documentation for the DELING API pilot project

Notifications You must be signed in to change notification settings

skat/deling-api-docs-pilot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DELING API Documentation

This is a site for providing documentation for the pilot project DELING API. It is hosted at https://skat.github.io/deling-api-docs.

The documentation is written with API Blueprint for the DELING project. If you have comments, change requests or similar, please add it as an issue and we will have a look at it.

For calling the API, replace localhost in the API documentation with the endpoint you have received from us.

The framework is provided by aglio, and converts the deling-api.md to html.

Postman collections

Postman collections are also provided for Car, Boat and Service API. To import the collections, use a version of Postman that supports Collection v2.1.

Updating content

Update the documentation file deling-api.md, and open a pull request to suggest changes.

Running documentation locally

To run the documentation locally you should have this repository checked out.

Installing dependencies

npm install -g aglio

Preview changes

aglio --theme-template triple -i deling-api.md -s

Publishing changes

The master branch is published as a GitHub page. It is published when a new change to index.html is pushed to master. To update index.html, run:

 aglio --theme-variables flatly -i deling-api.md --theme-template triple  -o index.html

About

Documentation for the DELING API pilot project

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages