This repository contains the public-facing docs for Stacklok's projects, hosted at https://docs.stacklok.com.
We welcome contributions to the Stacklok documentation - if you find something missing, wrong, or unclear, please let us know via an issue or open a PR!
Please review the style guide for help with voice, tone, and formatting.
You'll need Node.js available (v22 recommended) or VS Code with the Dev Containers extension and Docker.
npm install npm run start
This command starts a local development server on port 3000 and opens a browser window to http://localhost:3000. Most changes are reflected live without having to restart the server.
We use a combination of Prettier, markdownlint, and ESLint to normalize formatting and syntax. Before you submit a PR, please check for issues:
npm run prettier npm run markdownlint npm run eslint
To automatically fix issues:
npm run prettier:fix npm run markdownlint:fix npm run eslint:fix
The formatting commands also run as a pre-commit hook using Husky, so commits will fail if there are formatting issues that can't be fixed automatically. You can skip this by using git commit --no-verify
, but it's recommended to fix the issues instead since the P workflow will fail the checks anyway.
This command generates static content into the build
directory. It also checks for broken links, so it's recommended to run this before submitting a PR.
The docs.stacklok.com
site is published using Vercel. Automatic previews for branches and pull requests are enabled. The production site is published from the main
branch.
This site is built with Docusaurus.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4