Spectro Cloud Documentation

Welcome to the Spectro Cloud documentation repository. This repository contains the source for docs.spectrocloud.com.

Use this README as a quick start for contributing. For deeper guidance, see the contributor guides linked below.

For internal Spectro Cloud users, review the contributions section of the Documentation & Education team's home page.

Quick Start

The recommended local development path uses Docker.

1. Install the required software listed in the Local Development guide.

2. Initialize the repository.

   make init

3. Add your Palette API key to the .env file.

   PALETTE_API_KEY="<your-palette-api-key>"

4. Start the Docker-based local development server.

   make docker-start

5. Open http://localhost:9000 to view the documentation website.

For the non-Docker setup, refer to Local Development.

Make Documentation Changes

Create a branch for your changes.

git checkout -b <branch_name>

Most documentation pages are in the docs/docs-content folder. Make changes to the relevant Markdown or MDX files, then preview them locally.

make start

When your changes are ready, stage and commit them.

git add -A && git commit -m "docs: your commit message here"

Use the docs: commit prefix for regular documentation changes. Avoid feat:, fix:, perf:, and other semantic-release prefixes unless you intentionally need to trigger a version change.

Validate Your Changes

Run the checks that match your change before opening a pull request.

Check	Command	More information
Writing style	make check-writing	Checks and CI
Formatting	make format-check	Checks and CI
Full local CI setup	make ci-local	Release Process

The content in this repository requires approval from the documentation team. Approval rules are defined in CODEOWNERS.

Contributor Guides

Guide	Use it for
Local Development	Prerequisites, Docker setup, non-Docker setup, and local environment variables.
Authoring Content	Creating pages, organizing sidebars, tutorials, and reviewer guidance.
Markdown and MDX	Links, images, redirects, code blocks, and admonitions.
Components	Tabs, videos, tooltips, partials, badges, cards, and Palette/VerteX URL helpers.
Generated Content and Integrations	API docs, security bulletins, packs, cached generated data, and the Kapa widget.
Checks and CI	Netlify previews, Vale, Prettier, spellcheck, and build exit codes.
Release Process	Release branches, unreleased banners, Palette release automation, and release commands.
Style Guide	Spectro Cloud documentation style, grammar, formatting, and usage guidance.

Repository References

File or directory	Description
docs/docs-content	Main documentation content.
docs/api-content	API documentation content generated from OpenAPI specs.
_partials	Reusable MDX partials.
static/assets/docs/images	Documentation image assets.
CODEOWNERS	Pull request ownership and approval rules.
Makefile	Local development, validation, and release helper commands.

Related GitHub Repositories

Repository	Use it for
spectrocloud/librarium	Spectro Cloud documentation source.
spectrocloud/spectro-vale-pkg	Spectro Cloud Vale style rules.
spectrocloud/tutorials	Tutorial source and supporting examples.
spectrocloud/docs-assignments	Documentation assignment tracking.
spectrocloud/docusaurus-versioning-template	Historical Docusaurus versioning reference and demo template.
spectrocloud/hello-universe	Hello Universe sample application.
spectrocloud/hello-universe-api	Hello Universe API service.
spectrocloud/hello-universe-db	Hello Universe database service.