Conversation
docs(zsh-lint): add generated-reference markers and seed content
Re-add the {/* zsh-lint:generated:start/end */} markers to the Zsh Lint
ecosystem page so the wiki-docs-sync pipeline from z-shell/zsh-lint has a
region to inject into. Seed the region with the current generated Go
reference so the first automated sync is a no-op rather than a failure.
The marked region is machine-managed — do not hand-edit; it is regenerated
from the repo's Go doc comments.
Co-authored-by: Salvydas Lukosius <ss-o@users.noreply.github.com>
docs(zsh-lint): sync generated reference from zsh-lint
ci(trunk): rename workflow/job to Trunk Code Quality to fix duplicate check context The workflow and job were both named 'Trunk Check', colliding with the check that trunk-io/trunk-action posts (also 'Trunk Check'). Two identically-named check-runs confuse strict branch protection (required context 'Trunk Check'), leaving PRs stuck in BLOCKED even when all checks pass. Renaming to the org-conventional 'Trunk Code Quality' (matching other repos) leaves the action's 'Trunk Check' as the sole required context. Fixes #757. Co-authored-by: Salvydas Lukosius <ss-o@users.noreply.github.com>
The zsh package no longer ships 5.1.1 or 5.2.4 as selectable profiles (z-shell/zsh#14). Remove the two stale 'zi pack' examples so the usage page matches the available manifest profiles.
docs(zsh-lint): move tool documentation into community
…#802) The page linked z-shell/.github/.github/lib/labels.yml, a stale duplicate removed in z-shell/.github#471. The canonical file, and the one labels-sync.rb reads, is lib/labels.yml at that repository's root. Supports z-shell/.github#461.
Contributor
|
Size Change: -76 B (0%) Total Size: 6.59 MB 📦 View Changed
ℹ️ View Unchanged
|
Contributor
There was a problem hiding this comment.
Pull request overview
Promotes the current next branch state to main to publish the live Docusaurus site, including the fix for the previously dead canonical-labels link and a documentation restructure that relocates Zsh Lint content while preserving existing inbound URLs via redirects.
Changes:
- Fix and modernize “Project Management”/contributing docs to reflect Linear usage and correct the canonical labels source link.
- Move Zsh Lint docs from
ecosystem/tocommunity/, adding Cloudflare Pages redirects/routes so old URLs continue to work. - Align repo automation/tooling (reusable Trunk workflow, CodeQL concurrency/permissions, Crowdin concurrency, Renovate config) and update a couple dev dependency versions.
Reviewed changes
Copilot reviewed 18 out of 20 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| static/img/svg/community/contributing-project-management.svg | Updates the diagram label to match the Linear tracker naming. |
| static/_routes.json | Adds Cloudflare Pages routing exclusions so static redirects can take effect for legacy paths. |
| static/_redirects | Adds 301 redirects from the old Zsh Lint URL to the new community location. |
| renovate.json | Adds Renovate configuration extending the org preset. |
| package.json | Bumps @types/node and stylelint versions. |
| ecosystem/plugins/zsh_lint.mdx | Removes the old Zsh Lint page from the ecosystem section. |
| ecosystem/packages/02_usage.mdx | Removes older Zsh package versions from the documented list. |
| community/index.mdx | Updates copy, swaps tracker link to Linear, and adds a Zsh Lint card linking to the new page. |
| community/04_zsh_lint/index.mdx | Introduces the new Zsh Lint documentation page under community, including a generated reference section. |
| community/04_zsh_lint/category.json | Adds category metadata so the new Zsh Lint section appears correctly in navigation. |
| community/00_contributing/index.mdx | Updates the project tracker link to Linear. |
| community/00_contributing/05_project_management.mdx | Updates tracker section to Linear and fixes the canonical labels link target. |
| community/00_contributing/04_contributing_docs.mdx | Updates content-root description to include community tools. |
| AGENTS.md | Updates the content-root scope description to include Zsh Lint as a community tool. |
| .github/workflows/trunk-check.yml | Switches to the org reusable Trunk workflow and aligns concurrency/permissions. |
| .github/workflows/crowdin-upload.yml | Moves concurrency to workflow level and changes cancellation behavior. |
| .github/workflows/codeql.yml | Adds concurrency and sets top-level permissions while retaining job-level CodeQL permissions. |
| .github/instructions/docs-authoring.instructions.md | Updates root-selection guidance to include community tools like Zsh Lint. |
| .github/instructions/agent-docusaurus-writer.instructions.md | Updates agent guidance to include community tools like Zsh Lint. |
main carried 15 commits absent from next, and main requires branches to be up to date before merging. Brings them across so the promotion PR can proceed. The merge is clean; next's corrected labels.yml link is preserved.
Deploying zsh with
|
| Latest commit: |
c49d585
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://9bf671e1.zsh.pages.dev |
| Branch Preview URL: | https://next.zsh.pages.dev |
This was referenced Jul 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Promotes the accumulated
nextwork tomain, publishing the live site.Immediate driver
maincurrently contains a dead link.community/00_contributing/05_project_management.mdxonmainpoints athttps://github.com/z-shell/.github/blob/main/.github/lib/labels.yml, which became a 404 when that duplicate was removed in z-shell/.github#471. The corrected link is already onnext(#802).This is currently failing
Trunk Code Qualityonnext— lychee reports the 404 for the copy still onmain. Promoting resolves it.What ships (12 commits)
The substantive change beyond the link fix is a documentation restructure:
ecosystem/plugins/zsh_lint.mdx→community/04_zsh_lint/index.mdxstatic/_redirects— 301s from the old URLs to the new locationstatic/_routes.json— new, excludes the old paths so the static redirects take effectconcurrency,permissions, top-level policy blocks)Anyone holding a link to
/ecosystem/plugins/zsh_lintis redirected rather than 404d — worth spot-checking after deploy, since that pairing is the one live-behaviour risk here.Verification
nextHEAD: CodeQL, Analyze, and Cloudflare Pages all pass; the only failure is the lychee 404 this promotion fixesKnown follow-up, not addressed here
maincarries 15 commits not onnext(the branches are divergent). After this merge,nextwill still be missing them, repeating the pattern that produced31c8c94c chore(repo): reconcile main content into next. A reconcile back intonextshould follow.