Skip to content

docs: fix review findings (TOC, prerequisites order, phantom tutorial, CI checks, license headers, Ruff rules)#48

Merged
javierdelapuente merged 1 commit into
mainfrom
docs/fix-review-findings
Jun 2, 2026
Merged

docs: fix review findings (TOC, prerequisites order, phantom tutorial, CI checks, license headers, Ruff rules)#48
javierdelapuente merged 1 commit into
mainfrom
docs/fix-review-findings

Conversation

@javierdelapuente
Copy link
Copy Markdown
Collaborator

Summary

Applies fixes identified by a UX and technical documentation review.

README.md

  • Add table of contents — 425-line doc now has navigation
  • Prerequisites before Install — users see what they need before running install commands; clarified chicken-and-egg for spread (installed via opcli after opcli itself)
  • Remove phantom opcli tutorial command — not implemented; was actively misleading
  • Fix virtual backends descriptiontutorial backend type is also not implemented; removed

AGENTS.md

  • License header requirement — new constraint feat: add pytest command — expand and run #7; every new .py file needs the Apache header; CI enforces via skywalking-eyes
  • Undocumented CI checks added to enforcement table: codespell, license-check (skywalking-eyes), shellcheck
  • Add codespell to quick-start commands so agents run it before pushing
  • Fix Ruff rule set — previous list was incomplete; now references pyproject.toml with accurate rule group list
  • Remove tutorial from virtual backend type values — not implemented

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

- README: add table of contents
- README: move Prerequisites before Install opcli commands
- README: remove phantom 'opcli tutorial' command (not implemented)
- README: fix virtual backends description (tutorial type not implemented)
- AGENTS.md: add license header requirement as constraint #7
- AGENTS.md: add codespell, license-check, shellcheck to CI enforcement table
- AGENTS.md: add codespell to quick-start commands
- AGENTS.md: fix Ruff rule set (was incomplete; now references pyproject.toml)
- AGENTS.md: remove tutorial from virtual backend type values

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@javierdelapuente javierdelapuente merged commit 2c5dec9 into main Jun 2, 2026
22 checks passed
@javierdelapuente javierdelapuente deleted the docs/fix-review-findings branch June 2, 2026 08:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant