Skip to content

tenzir/docs

Folders and files

NameName
Last commit message
Last commit date
Mar 21, 2025
Mar 4, 2025
Feb 1, 2025
Mar 21, 2025
Mar 4, 2025
Mar 4, 2025
Mar 4, 2025
Mar 21, 2025
Feb 14, 2025
Mar 21, 2025
Mar 20, 2025
Mar 21, 2025
Mar 3, 2025
Feb 14, 2025
Feb 1, 2025

Repository files navigation

Tenzir Documentation

This repository hosts the documentation of Tenzir.

๐Ÿšง WORK IN PROGRESS ๐Ÿšง

The content in this repository is not yet authoritative. If you look for the Tenzir documentation, go to docs.tenzir.com.

We are in the process of migrating our docs from Docusaurus to Starlight. You can find a preview of the new documentation at tenzir.github.io/docs.

โ˜‘๏ธ TODOs

Structure

  • Split nav at the top
  • Render API docs based on OpenAPI spec
  • Generate a sitemap at build time
  • Publish to GitHub Pages
  • Implement broken links check
  • Upgrade to Starlight 0.32 and re-implement Starlight Utils
  • Make logo href be tenzir.com

CI / Automation

  • Update tenzir.yaml.example via CI
  • Update OpenAPI spec via CI
  • Create consolidated Node & Platform changelog
    • Creat CI job in tenzir/tenzir
    • Creat CI job in tenzir/platform
    • Update changelog.mdx in this repo

Style

  • Hoist SVGs and apply auto-darkmode
  • TQL syntax highlighting
  • Fix sliding top nav bar on Firefox
  • Fix sizing calculator iframe height (CSS?)
  • Fix github-{light,dark} syntax theme selection
  • Fix Integrations tab not being bold font inside
  • Do CSS magic to fuse subsequent TQL code blocks
  • Apply CSS and get a facelift
  • Style Asides to match design system

Content

  • Landing page
  • FAQs
  • Integrations
  • Explanations
  • Tutorials
  • Guides
  • Reference
    • Language
    • Operators
    • Functions
    • Configuration
    • Platform CLI
    • Glossary

Legal

  • SBOM at /sbom
  • Privacy Statement (or link to it)

๐Ÿš€ Relaunch

  • Fix all broken links and uncomment link checking in CI
  • Replace site and base in astro.config.mjs

Stretch

These don't have to be addressed prior to the relaunch, but would be nice:

  • New Quickstart guide

โœŠ Usage

Fetch external content, such as Markdown files from our .github repo:

make

Install the web framework dependencies:

pnpm install

Then view the docs locally:

pnpm dev

Here's an summary about frequently used commands:

Command Action
pnpm install Installs dependencies
pnpm dev Starts local dev server at localhost:4321
pnpm build Build your production site to ./dist/
pnpm preview Preview your build locally, before deploying
pnpm astro ... Run CLI commands like astro add, astro check
pnpm astro -- --help Get help using the Astro CLI

๐Ÿ™‹ Help

Check out Starlightโ€™s docs, read Astro's documentation, or jump into Tenzir's Discord server.