Skip to content

[docs] docs: unbloat troubleshooting common issues - #51251

Merged
pelikhan merged 1 commit into
mainfrom
docs/unbloat-common-issues-218a837769d688d0
Aug 8, 2026
Merged

[docs] docs: unbloat troubleshooting common issues#51251
pelikhan merged 1 commit into
mainfrom
docs/unbloat-common-issues-218a837769d688d0

Conversation

@github-actions

@github-actionsgithub-actionsBot commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Summary

Condenses the troubleshooting common-issues guide by converting several bulleted/numbered lists into concise prose paragraphs, reducing verbosity while preserving all technical content and links.

Changes

  • File: docs/src/content/docs/troubleshooting/common-issues.md (docs-only, no code/schema/behavior changes)
  • Merged list-based explanations into flowing prose for:
    • Actions Restrictions Reported During Init (3-item list to one sentence)
    • OpenCode "Key gotchas" bullets
    • Engine-Specific Issues (Copilot CLI not found / model not available)
    • Copilot Engine Prerequisites on GHES (kept the aw wrap YAML example)
    • Context Expression Issues
    • Build and Test Issues
  • Lightly reworded Operational Runbooks and Getting Help sections for conciseness

Impact

  • Type: Documentation only
  • Breaking: No
  • Risk: Low, no functional, schema, or code changes
Minor note

The reworded "Getting Help" sentence contains a small duplicated phrase ("search existing issues" appears twice) introduced by the rewrite; may be worth a follow-up cleanup.

> Generated by [PR Description Updater](https://github.com/github/gh-aw/actions/runs/31231786566) for #51251 · auto · 46.7 AIC · ⌖ 2.65 AIC · ⊞ 6.9K · [◷](https://github.com/search?q=repo%3Agithub%2Fgh-aw+%22gh-aw-workflow-call-id%3A+github%2Fgh-aw%2Fpr-description-caveman%22&type=pullrequests)

@github-actionsgithub-actionsBot added automation doc-unbloat documentation Improvements or additions to documentation labels Aug 8, 2026
@pelikhan
pelikhan marked this pull request as ready for review August 8, 2026 01:04
CopilotAI balanced review requested due to automatic review settings August 8, 2026 01:04
@pelikhan
pelikhan merged commit f6e39fb into mainAug 8, 2026
1 check passed
@pelikhan
pelikhan deleted the docs/unbloat-common-issues-218a837769d688d0 branch August 8, 2026 01:04
@github-actions

github-actionsBot commented Aug 8, 2026

Copy link
Copy Markdown
ContributorAuthor

Test Quality Sentinel completed test quality analysis.

No test files were added or modified in this PR. Test Quality Sentinel skipped. This is a documentation-only change.

🧪 Test quality analysis by Test Quality Sentinel

CopilotAI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Condenses troubleshooting documentation while retaining core guidance and examples.

Changes:

  • Replaces repetitive lists with concise prose.
  • Tightens engine, GHES, build, and support guidance.
  • One original documentation link was inadvertently removed.
Show a summary per file
FileDescription
docs/src/content/docs/troubleshooting/common-issues.mdStreamlines troubleshooting sections and formatting.

Review details

Tip

Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

  • Files reviewed: 1/1 changed files
  • Comments generated: 1
  • Review effort level: Balanced

1. **Actions disabled**: Enable Actions ([docs](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository))
2. **Local-only**: Switch to "Allow all actions" or enable GitHub-created actions ([docs](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#managing-github-actions-permissions-for-your-repository))
3. **Selective allowlist**: Enable "Allow actions created by GitHub" checkbox ([docs](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-select-actions-and-reusable-workflows-to-run))
The CLI validates three permission layers in Repository Settings → Actions → General: enable Actions, switch from local-only restrictions to allowing GitHub-created or all actions, and, if you're using a selective allowlist, enable GitHub-created actions as well. See the [repository Actions settings docs](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository) and [allowlist details](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-select-actions-and-reusable-workflows-to-run).
@github-actions

Copy link
Copy Markdown
ContributorAuthor

🎉 This pull request is included in a new release.

Release: v0.86.2

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automationdoc-unbloatdocumentationImprovements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@pelikhan