teleport/docs
2018-01-08 13:01:35 -08:00
..
1.3 Re-merged multi-version docs from a separate repo 2017-03-23 21:00:33 -07:00
2.0 Made installation procedure consistent in the docs 2017-10-09 18:36:22 -07:00
2.3 2.4 documentation 2018-01-08 12:16:26 -08:00
2.4 Kate's changed files 2018-01-08 13:01:35 -08:00
theme 2.4 version template 2018-01-07 16:32:43 -08:00
1.3.yaml Re-merged multi-version docs from a separate repo 2017-03-23 21:00:33 -07:00
2.0.yaml docs and screenshots for Okta and SAML 2017-05-22 18:44:59 -07:00
2.3.yaml Added 2.3 version of the docs 2017-08-14 14:58:41 -07:00
2.4.yaml 2.4 version template 2018-01-07 16:32:43 -08:00
build.sh Updated company address in the documentation footer 2017-10-05 14:16:47 -07:00
index.html 2.4 version template 2018-01-07 16:32:43 -08:00
ISSUE_TEMPLATE.md Create ISSUE_TEMPLATE.md 2018-01-06 15:32:52 -08:00
README.md 2.4 version template 2018-01-07 16:32:43 -08:00
run.sh Improved documentation-building scripts 2017-08-17 17:03:53 -07:00
testplan.md Added manual test plan for Teleport. 2018-01-04 13:12:06 -08:00

Teleport Docs

Teleport docs are built using mkdocs and hosted as a bunch of static files in S3.

Look at build.sh script to see how it works.

To Publish New Version

  • Update build.sh.
  • Update index.html to redirect to the latest version automatically.
  • Update theme/base.html to add a new version to the Javascript arrray of versions
  • Create a new YAML file, like 5.5.1.yaml if you are releasing version 5.5.1

Deploying

Teleport docs are published using a private web repository. See web/README.md for more info.

Running Locally

To run the latest version of the docs on http://127.0.0.1:8000:

$ ./serve.sh

To run a specific version of the docs:

$ mkdocs serve --config-file 1.3.yaml