Fancy2209 / docs

AwayJS Static Docs Generator

AwayJS Documentation

This project produces a static documentation site for the AwayJS software API. AwayJS is written in Typescript and the documentation is generated using Typedoc, so the docs, as the code, are fully typed.

Self Deployment

Any push to any of the AwayJS modules will trigger a Travis CI rebuild of the documentation, so the static docs site should remain up to date with the source code from the dev branches at all times. Travis publishes the generated docs in the gh-pages branch and can hence be viewed in the browser at: https://awayjs.github.io/docs

Generate Local Copy

This repository does not track any documentation files or output, only the generator files, so in order to obtain a local copy of the documentation, you will have to clone this repository and run the generation yourself:

npm install

and then,

npm run docs

This will generate a bin folder with the documentation. Note that you will have to repeat the above commands each time you want to get the latest docs.

Another alternative for obtaining a local copy of the docs is to checkout the gh-pages branch, or download the zip file for the branch.

Feedback

Please provide any feedback in this repository. We are here to help. Hopefully this will be a valuable resource and reference to AwayJS users.