Admonition Test
Single line
This is a short note. See arrowair.com for more.
This is a short tip. Check the Discord for help.
This is a short info. Read the docs to learn more.
This is a short warning. Review the contributing guide before proceeding.
This is a short danger. See the changelog on GitHub.
Multi-line content
Arrow is an open-source organization building UAV hardware and the software stack for autonomous aerial mobility. Learn more at arrowair.com.
This is a second paragraph inside a note admonition. Visit the community forum to get involved.
Use npm start to launch the dev server at localhost:3000.
Run npm run build before deploying to catch any static build errors early.
The docs use a multi-instance Docusaurus setup. Each section — Main, Quiver, Flight Tracking, Bounty Board, and Spearhead — has its own source directory and sidebar config.
Merging directly to main without going through staging will bypass CI checks. Always open PRs against staging first. See the branching guide for the correct workflow.
Double-check your branch before pushing.
Do not delete the docs-project-quiver/ directory. It is auto-generated by import-external-docs.sh and will be overwritten on the next build — but a manual delete can break the dev server mid-session.
With inline code and links
See the contributing guide for how to get started. Run npm run typecheck to validate TypeScript before opening a PR.
The search index is built by @easyops-cn/docusaurus-search-local. It only indexes production builds — npm start will not populate search results.
Avoid using git push --force on staging. This branch is shared and a force push will rewrite history for all contributors. Use git push --force-with-lease if absolutely necessary.
With lists
Before submitting a PR, check the following:
- Run
npm run typecheck - Run
npm run buildand confirm no errors - Check that sidebar labels render correctly in the browser
- Verify dark mode looks correct
The following actions can break the production site. Review the deployment docs before making changes:
- Deleting
docusaurus.config.js - Removing a sidebar entry that a page references by ID
- Renaming a doc without adding a redirect
- Pushing an untested build to
main
Back to back
First note in a sequence.
Immediately followed by a tip.
Then an info.
Then a warning.
And finally a danger.