From 265071d26e3de36caa20e15b8d83eddd07c6ca17 Mon Sep 17 00:00:00 2001 From: Abdelrahman Essawy Date: Mon, 27 Apr 2026 11:52:17 +0300 Subject: [PATCH] chore: standardize metadata + brand-consistency rules across repo MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Trailing-slash fixes on apex page links (apex Astro is `trailingSlash:"always"`): - README.md: 4 instances of `https://rendobar.com/docs` → `/docs/` (header link, "Full usage" link, two Support section links) - README.md: `https://rendobar.com/docs/cli` → `https://rendobar.com/docs/cli/` - .github/ISSUE_TEMPLATE/config.yml: docs URL gains trailing slash Install/uninstall script URLs are unchanged — `rendobar.com/install.sh` etc. are files, not pages; they correctly stay slash-less. CLAUDE.md / AGENTS.md updates: - New "Cross-repo brand consistency" section pointing to apex `.claude/rules/brand-consistency.md` as the canonical source of truth - Embedded critical rules locally so an agent in this repo doesn't need to context-switch: canonical brand strings, package.json description format (em-dash, sentence case), README/issue-template trailing-slash rule, no AI attribution in commits/PRs - Anti-patterns list These rules mirror the apex monorepo's brand-consistency rule and the docs repo's CLAUDE.md, so future agents working in any rendobar repo land on the same conventions. No code changes. No release-please bump (chore commit). --- .github/ISSUE_TEMPLATE/config.yml | 2 +- AGENTS.md | 63 +++++++++++++++++++++++++++++++ CLAUDE.md | 63 +++++++++++++++++++++++++++++++ README.md | 8 ++-- 4 files changed, 131 insertions(+), 5 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index db6e29f..624413d 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1,7 +1,7 @@ blank_issues_enabled: false contact_links: - name: Documentation - url: https://rendobar.com/docs + url: https://rendobar.com/docs/ about: Guides, API reference, examples - name: Website url: https://rendobar.com diff --git a/AGENTS.md b/AGENTS.md index bdc5b72..7a75dc3 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,6 +9,69 @@ Guide for agents and humans working on the Rendobar CLI. Companion doc for the m - **Release**: conventional commits → release-please → tag → `cli-binaries.yml` builds 5 platform binaries with attestations → GitHub Release - **No manual tags, no manual version bumps** +--- + +## Cross-repo brand consistency + +This repo is part of the broader Rendobar platform. The canonical reference +for brand strings, URLs, OG metadata, robots policy, and title/description +rules across **every** rendobar repo lives in the apex monorepo at +`rendobar/rendobar` `.claude/rules/brand-consistency.md`: + +https://github.com/rendobar/rendobar/blob/main/.claude/rules/brand-consistency.md + +Critical rules embedded here so you don't need to context-switch: + +### Canonical brand strings (must match apex) + +| Field | Value | +|---|---| +| Display name | `Rendobar` | +| Apex URL | `https://rendobar.com` | +| Apex page URLs | `https://rendobar.com//` (always trailing slash) | +| API URL | `https://api.rendobar.com` | +| Dashboard URL | `https://app.rendobar.com` | +| CDN URL | `https://cdn.rendobar.com` | +| Twitter handle | `@rendobar` | + +**Forbidden variants**: `Rendobar.com`, `the Rendobar platform`, `rendobar` +(lowercase except in URLs / package names), `https://www.rendobar.com`, +`http://rendobar.com`, apex page links without a trailing slash. + +### `package.json description` — em-dash, sentence case + +- ✅ `"Rendobar CLI — serverless video processing from your terminal."` +- ❌ `"Rendobar | CLI Tool"` (pipe, title case) +- ❌ `"Rendobar CLI - serverless..."` (ASCII hyphen instead of em-dash) + +### README + issue templates — trailing slash on apex page links + +Apex Astro is configured with `trailingSlash: "always"`. Every link to an +`https://rendobar.com/` page **must end with `/`**: +- ✅ `https://rendobar.com/docs/`, `https://rendobar.com/blog/`, `https://rendobar.com/pricing/` +- ❌ `https://rendobar.com/docs`, `https://rendobar.com/blog` + +The apex root (`https://rendobar.com`) and subdomain roots +(`https://api.rendobar.com`, `https://app.rendobar.com`, +`https://cdn.rendobar.com`) are file/origin URLs and stay slash-less. + +The install scripts at `https://rendobar.com/install.sh` etc. are FILES, not +pages — they correctly stay slash-less. + +### No AI attribution in commits / PRs + +Per the user's global rule (also in apex): never add `Co-Authored-By: Claude`, +`🤖 Generated with [Claude Code]`, or any AI attribution in commit messages or +PR descriptions. Strip them silently if a template injects them. + +### Anti-patterns — never do these + +- Use a brand-string variant other than canonical `Rendobar` +- Use `Rendobar | ...` (pipe) or `Rendobar - ...` (ASCII hyphen) in package.json description +- Skip the trailing slash on a `https://rendobar.com/` link in README, issue templates, install scripts that print URLs, or workflow files +- Reference `rendobar.com/blog`, `rendobar.com/pricing`, `rendobar.com/docs` without trailing slash +- Add a `Co-Authored-By: Claude` or "Generated with [Claude Code]" line in commit messages or PR descriptions + ## Dev loop ```bash diff --git a/CLAUDE.md b/CLAUDE.md index bdc5b72..7a75dc3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -9,6 +9,69 @@ Guide for agents and humans working on the Rendobar CLI. Companion doc for the m - **Release**: conventional commits → release-please → tag → `cli-binaries.yml` builds 5 platform binaries with attestations → GitHub Release - **No manual tags, no manual version bumps** +--- + +## Cross-repo brand consistency + +This repo is part of the broader Rendobar platform. The canonical reference +for brand strings, URLs, OG metadata, robots policy, and title/description +rules across **every** rendobar repo lives in the apex monorepo at +`rendobar/rendobar` `.claude/rules/brand-consistency.md`: + +https://github.com/rendobar/rendobar/blob/main/.claude/rules/brand-consistency.md + +Critical rules embedded here so you don't need to context-switch: + +### Canonical brand strings (must match apex) + +| Field | Value | +|---|---| +| Display name | `Rendobar` | +| Apex URL | `https://rendobar.com` | +| Apex page URLs | `https://rendobar.com//` (always trailing slash) | +| API URL | `https://api.rendobar.com` | +| Dashboard URL | `https://app.rendobar.com` | +| CDN URL | `https://cdn.rendobar.com` | +| Twitter handle | `@rendobar` | + +**Forbidden variants**: `Rendobar.com`, `the Rendobar platform`, `rendobar` +(lowercase except in URLs / package names), `https://www.rendobar.com`, +`http://rendobar.com`, apex page links without a trailing slash. + +### `package.json description` — em-dash, sentence case + +- ✅ `"Rendobar CLI — serverless video processing from your terminal."` +- ❌ `"Rendobar | CLI Tool"` (pipe, title case) +- ❌ `"Rendobar CLI - serverless..."` (ASCII hyphen instead of em-dash) + +### README + issue templates — trailing slash on apex page links + +Apex Astro is configured with `trailingSlash: "always"`. Every link to an +`https://rendobar.com/` page **must end with `/`**: +- ✅ `https://rendobar.com/docs/`, `https://rendobar.com/blog/`, `https://rendobar.com/pricing/` +- ❌ `https://rendobar.com/docs`, `https://rendobar.com/blog` + +The apex root (`https://rendobar.com`) and subdomain roots +(`https://api.rendobar.com`, `https://app.rendobar.com`, +`https://cdn.rendobar.com`) are file/origin URLs and stay slash-less. + +The install scripts at `https://rendobar.com/install.sh` etc. are FILES, not +pages — they correctly stay slash-less. + +### No AI attribution in commits / PRs + +Per the user's global rule (also in apex): never add `Co-Authored-By: Claude`, +`🤖 Generated with [Claude Code]`, or any AI attribution in commit messages or +PR descriptions. Strip them silently if a template injects them. + +### Anti-patterns — never do these + +- Use a brand-string variant other than canonical `Rendobar` +- Use `Rendobar | ...` (pipe) or `Rendobar - ...` (ASCII hyphen) in package.json description +- Skip the trailing slash on a `https://rendobar.com/` link in README, issue templates, install scripts that print URLs, or workflow files +- Reference `rendobar.com/blog`, `rendobar.com/pricing`, `rendobar.com/docs` without trailing slash +- Add a `Co-Authored-By: Claude` or "Generated with [Claude Code]" line in commit messages or PR descriptions + ## Dev loop ```bash diff --git a/README.md b/README.md index 74127dc..740c834 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@

Website • - Docs • + Docs • SDK • Latest Release

@@ -77,7 +77,7 @@ rb ffmpeg -i input.mp4 -vf "drawtext=text='PREVIEW':fontsize=48:fontcolor=white@ rb --help ``` -Full usage: [rendobar.com/docs/cli](https://rendobar.com/docs/cli) +Full usage: [rendobar.com/docs/cli/](https://rendobar.com/docs/cli/) ## Auto-update @@ -94,7 +94,7 @@ Self-replaces the binary in-place with checksum verification and automatic rollb Rendobar is a serverless media processing platform — watermark, transcode, caption, render videos with one API call. Credit-based billing. MCP-native for AI agents. - **Website**: https://rendobar.com -- **Docs**: https://rendobar.com/docs +- **Docs**: https://rendobar.com/docs/ - **API**: https://api.rendobar.com - **SDK**: [@rendobar/sdk](https://www.npmjs.com/package/@rendobar/sdk) on npm @@ -133,7 +133,7 @@ Commit messages must follow [Conventional Commits](https://www.conventionalcommi - **Bugs**: [open an issue](https://github.com/rendobar/cli/issues/new?template=bug.md) - **Feature requests**: [open an issue](https://github.com/rendobar/cli/issues/new?template=feature.md) -- **Docs**: https://rendobar.com/docs +- **Docs**: https://rendobar.com/docs/ - **Contact**: hello@rendobar.com ## License