Skip to content

Latest commit

 

History

History
52 lines (31 loc) · 2.6 KB

README.md

File metadata and controls

52 lines (31 loc) · 2.6 KB

NeSI support documentation

Open in GitHub Codespaces

Deploy to gh-pages

This repository contains the sources files for the NeSI support documentation.

Rendered pages are visible at https://docs.nesi.org.nz.

Contents

The repository is organised using the following folders:

  • checks : scripts intended to be run by CI,
  • docs: markdown files, structure determines categories and sections1,
  • docs/assets: non-template related files, e.g. images,
  • overrides: theme overides or extensions for page templates.
  • overrides/partials: Overrides and extensions for sub components.

Developer Documentation

Following pages contain information to help maintain the documentation:

Viewing PR Branches

Demo Site

Deployments of open pull requests can be viewed at https://callumwalley.github.io/support-docs-dev/NAME-OF-BRANCH

Theme

We are using the mkdocs material theme.

Analyics

The site uses Google analytics. You will need to ask a google workspace admin to add you to the project.

Migration

Migration of the Zendesk documentation is done using our migration pipeline (NeSI internal GitLab.

Any one off filters (e.g. don't need to be checked every time, just when converting from ZD) should go there.

Footnotes

  1. A section or category can be replaced by an index.md file, this will replace the default nav with a page.