markdownlint
- Disable MD028 (no-blanks-blockquote): we intentionally separate
adjacent blockquote callouts (a tip + a warning side-by-side) with
a blank line; visually this renders as two callouts, which is the
intent.
- Switch MD029 (ol-prefix) to "one_or_ordered": both "1. / 2. / 3."
and "1. / 1. / 1." (auto-renumber) are valid; the rule was hitting
ordered lists that have intervening code blocks, where the lint
loses count.
- Add blank lines before lists in five places where MD032 fired
(test.md, git-release/SKILL.md, agents.md, skills.md, migration.md).
- Fix nested code-fence bug in database-engineer-prompt.md: the
outer ``` was being closed by an inner ```sql; switched the outer
fence to ```` (4 backticks) so the inner one stays nested.
link-check
- Ignore https://mcp.grep.app and https://ai.google.dev/ — the first
returns 405 to HEAD requests (verified working via GET); the second
trips an infinite-redirect bug in the link checker (real URL works).
- Ignore github.com/anomalyco/opencode/discussions — the upstream
repo currently has discussions disabled.
- Add 405 to aliveStatusCodes for endpoints that accept GET but
reject HEAD.
Community and contributor support:
- CONTRIBUTING.md: what we welcome, what we don't, style guide,
templates for MCP walkthroughs and specialized-agent prompts.
- CODE_OF_CONDUCT.md: Contributor Covenant 2.1.
- SECURITY.md: scope (this is a docs repo, not application code), how
to report a vulnerability in the example plugins or in misleading
documentation, where OpenCode-core bugs should go instead.
GitHub plumbing:
- .github/PULL_REQUEST_TEMPLATE.md: type, sources, hygiene checklist.
- .github/ISSUE_TEMPLATE/{bug_report,feature_request}.md and config.yml
that redirects OpenCode-tool issues to the right place.
- .github/workflows/lint-docs.yml: three jobs on every push and PR —
markdownlint, link check (with sensible ignore patterns for
../../issues, security advisories, localhost), codespell with a
project-specific ignore list.
Lint/style configs:
- .markdownlint.json + .markdownlintignore: ATX headings, ordered list
numbering, line-length and inline-HTML rules tuned for our content.
- .editorconfig: LF, UTF-8, 2-space indent, trim trailing whitespace
except in markdown (where trailing spaces are line breaks).