Update the LibreYOLO website (signpost)
The website is not in this repo. Deep guides live with the code they describe; this signpost only tells you where to go and when you must.
The repos
| Repo | Role | Authoritative skills there |
|---|---|---|
LibreYOLO/libreyolo-website (local: C:\Users\Usuario\Documents\GitHub\libreyolo-website) |
The Next.js site behind https://www.libreyolo.com (docs pages, articles content) |
put-website-in-prod (the only supported deploy path) |
marketing (local: C:\Users\Usuario\Documents\GitHub\marketing) |
Content pipelines | website-article-writer, website-article-publisher, new-version-release |
Those skills are authoritative for layout, conventions, and deploy mechanics. If anything here disagrees with them, they win; update this signpost rather than diverging.
Two facts worth carrying in (they bite outsiders)
- Deploys are manual. Pushing to the website repo does NOT deploy.
Production goes live only via the
put-website-in-prodskill (globalvercelCLI,vercel --prod). "I merged the docs change" is not "the docs are live". - Public raw links into the library repo must use
/release/, never/main/. The library has nomainbranch; a/main/raw URL 404s. Use/dev/only for deliberately-unstable references.
When a library change REQUIRES a website update
- A new model family, task, or CLI command that users are meant to find
(the repo
docs/are contributor contracts; user docs live on the site). - Changed user-facing behavior the site currently documents (check before shipping: search the website repo for the old name/flag).
- A release: the release process (
skills/libreyolo-release/Gate G) lists headline changelog items with no doc mention; each needs a site update or the user's explicit "ship without docs" per item. - For features without full validation, state the exact completed checks and known limits without changing whether the implemented API is shown as available.
When a feature ships without its docs, say so in the PR/release handoff rather than letting it be discovered.
Flow
- Land and verify the library change first (docs describing unmerged behavior is drift in the other direction).
- Switch to the website checkout; follow its conventions (articles have a
bilingual
.md+.zh.mdconvention and FAQ frontmatter; read the marketing repo'swebsite-article-writerbefore writing any article). - Deploy with
put-website-in-prodfrom the website repo. Verify the live page renders after deploy; do not report done on a successful build alone.
Related
skills/libreyolo-release/Gate G: the docs-drift gate this feeds.skills/benchmark-on-visionanalysis/: the analogous signpost for the benchmark site (visionanalysis.org), which is a third, different repo.