mirror of
https://github.com/zed-industries/zed.git
synced 2026-06-02 07:04:33 +00:00
dc41f71f57
Adds scripts and a GitHub Action workflow for automatically suggesting documentation updates when PRs modify user-facing code. ## Scripts - **`script/docs-suggest`**: Analyze PRs/commits for documentation needs using AI - **`script/docs-suggest-publish`**: Create a PR from batched suggestions - **`script/docs-strip-preview-callouts`**: Remove Preview callouts when shipping to stable - **`script/test-docs-suggest-batch`**: Testing utility for batch analysis ## Workflow The GitHub Action (`.github/workflows/docs_suggestions.yml`) handles two scenarios: 1. **PRs merged to main**: Suggestions are batched to `docs/suggestions-pending` branch for the next Preview release 2. **Cherry-picks to release branches**: Suggestions are posted as PR comments for immediate review ## Callout Types The system distinguishes between: - **Additive features** (new commands, settings, UI): ```markdown > **Preview:** This feature is available in Zed Preview. It will be included in the next Stable release. ``` - **Behavior modifications** (changed defaults, altered existing behavior): ```markdown > **Changed in Preview (v0.XXX).** See [release notes](/releases#0.XXX). ``` Both callout types are stripped by `docs-strip-preview-callouts` when features ship to stable. ## Example Output See PR #49190 for example documentation suggestions generated by running this on PRs from the v0.224 preview window. ## Usage ```bash # Analyze a PR (auto-detects batch vs immediate mode) script/docs-suggest --pr 49100 # Dry run to see assembled context script/docs-suggest --pr 49100 --dry-run # Create PR from batched suggestions script/docs-suggest-publish # Strip callouts for stable release script/docs-strip-preview-callouts ``` Release Notes: - N/A |
||
|---|---|---|
| .. | ||
| add_commented_closed_issue_to_project.yml | ||
| after_release.yml | ||
| autofix_pr.yml | ||
| background_agent_mvp.yml | ||
| bump_collab_staging.yml | ||
| bump_patch_version.yml | ||
| catch_blank_issues.yml | ||
| cherry_pick.yml | ||
| community_champion_auto_labeler.yml | ||
| community_close_stale_issues.yml | ||
| community_update_all_top_ranking_issues.yml | ||
| community_update_weekly_top_ranking_issues.yml | ||
| compare_perf.yml | ||
| congrats.yml | ||
| danger.yml | ||
| deploy_cloudflare.yml | ||
| deploy_collab.yml | ||
| docs_automation.yml | ||
| docs_suggestions.yml | ||
| extension_bump.yml | ||
| extension_tests.yml | ||
| extension_workflow_rollout.yml | ||
| good_first_issue_notifier.yml | ||
| identify_potential_duplicate_issues.yml | ||
| pr_labeler.yml | ||
| publish_extension_cli.yml | ||
| randomized_tests.yml | ||
| release.yml | ||
| release_nightly.yml | ||
| run_agent_evals.yml | ||
| run_bundling.yml | ||
| run_cron_unit_evals.yml | ||
| run_tests.yml | ||
| run_unit_evals.yml | ||
| slack_notify_first_responders.yml | ||