teleport/docs
2018-02-10 12:59:44 -05:00
..
1.3 Re-merged multi-version docs from a separate repo 2017-03-23 21:00:33 -07:00
2.0 (web) docs new nav styles 2018-02-08 13:58:36 -05:00
2.3 (web) docs new nav styles 2018-02-08 13:58:36 -05:00
2.4 (web) docs new nav styles 2018-02-08 13:58:36 -05:00
theme (docs) updated logo 2018-02-10 12:59:44 -05:00
1.3.yaml (web) docs new nav styles 2018-02-08 13:58:36 -05:00
2.0.yaml (web) docs new nav styles 2018-02-08 13:58:36 -05:00
2.3.yaml (web) docs new nav styles 2018-02-08 13:58:36 -05:00
2.4.yaml An experiment at 3-level navigation 2018-02-08 13:58:36 -05:00
build.sh (docs) update build scripts 2018-02-08 13:58:36 -05: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 (docs) update build scripts 2018-02-08 13:58:36 -05: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