From fd90fd3e72bb67cb33c62320fb39be2e2c41c88d Mon Sep 17 00:00:00 2001 From: ukimsanov Date: Mon, 3 Aug 2026 17:46:22 -0700 Subject: [PATCH] docs: correct the docs rules and label the Prompt Guide previews MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Three things the quality layer asserted but the pages did not support. changelog-process said "do not recreate docs/weekly-updates.mdx; that empty public page was retired" while the page exists with a real curated feed. It describes the page as it is: unlisted, reachable by URL and RSS, with versioned notes still in the Changelog. The Related-topics rule read as universal, but three different endings are in use and each is right for its shape — Related topics on task pages, a single Next line through the Prompt Guide's numbered sequence, and nothing on reference and concept pages. The rule now says that, and every section matches it; color-grading gained the Next line it was missing and no longer points at a page this stack retired. The vocabulary previews were 18 DocsVideo players in three unlabelled grids, so a reader saw several near-identical clips with no way to tell smooth from snappy. They are now native muted loops with visible captions, which is what AGENTS.md asks for small preview loops in the first place. --- docs/AGENTS.md | 15 +- docs/contributing/changelog-process.mdx | 2 +- docs/prompting/color-grading.mdx | 4 +- docs/prompting/vocabulary.mdx | 362 ++++++++++++++++++------ 4 files changed, 286 insertions(+), 97 deletions(-) diff --git a/docs/AGENTS.md b/docs/AGENTS.md index 925b7ab30..c73084b38 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -54,9 +54,18 @@ narrated film a reader watches intentionally. A plain `