This folder generates the API docs for NStack.

The API documentation is generated via a GitHub Action (.github/workflows/api-docs.yml) using DocFX. The Action publishes the docs to the gh-pages branch, which gets published to https://tui-cs.github.io/NStack/.

0. Install DotFX https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html
1. Change to the ./docfx folder and run ./build.ps1
2. Browse to http://localhost:8080 and verify everything looks good.
3. Hit ctrl-c to stop the script.

If docfx fails with a Stackoverflow error. Just run it again. And again. Sometimes it takes a few times. If that doesn't work, create a fresh clone or delete the docfx/api, docfx/obj, and docs/ folders and run the steps above again.

Note the ./docfx/build.ps1 script will create a ./docs folder. This folder is ignored by .gitignore.