Skip to content

fix: correct documentation drift (Python version, security email, commit policy) - #714

Merged
n24q02m merged 1 commit into
mainfrom
fix/docs-audit-qwen3
Jun 10, 2026
Merged

fix: correct documentation drift (Python version, security email, commit policy)#714
n24q02m merged 1 commit into
mainfrom
fix/docs-audit-qwen3

Conversation

@n24q02m

@n24q02m n24q02m commented Jun 10, 2026

Copy link
Copy Markdown
Owner

Summary

Documentation drift audit + fix for the public qwen3-embed release repo. All findings verified against actual code/config before editing.

Findings fixed

File Drift Fix Evidence
AGENTS.md Header said "Python >= 3.13" Now ">= 3.11 (tested 3.11-3.14)" pyproject.toml requires-python = ">=3.11" + classifiers 3.11-3.14; CLAUDE.md
SECURITY.md Contact n24q02m@gmail.com Canonical quangminh2402.dev@gmail.com Sibling repos (web-core, mnemo-mcp, wet-mcp, mcp-core, better-notion-mcp) all use canonical
CODE_OF_CONDUCT.md Same drifted email Canonical email (consistency) same as above
CONTRIBUTING.md Generic Conventional Commits link implied all types allowed Clarified only feat:/fix: accepted (commit-msg hook) scripts/enforce-commit.sh rejects everything except feat/fix (+chore(release): for PSR)

Findings checked, NOT changed (already correct)

  • AGENTS.md "Target: Python 3.13" + --target-version=py313 — accurate: .pre-commit-config.yaml passes --target-version=py313, mise.toml pins dev python 3.13.
  • AGENTS.md ignore = ["E501"] — matches pyproject.toml [tool.ruff.lint].
  • README.md — no hardcoded version (uses PyPI badge); model table, install commands, env vars all match code. No dead links (library repo, no mcp-core/docs/TRUST-MODEL.md or /servers/<slug>/ references).
  • SECURITY.md supported-versions table — intentionally version-agnostic ("latest"/"< latest"), not stale.

Verification

  • uv run ruff check . → All checks passed
  • Pre-commit hooks (incl. commit-msg feat:/fix: enforcement + diacritics) passed on commit

🤖 Generated with Claude Code

- AGENTS.md: Python floor is >=3.11 (tested 3.11-3.14), not >=3.13
- SECURITY.md + CODE_OF_CONDUCT.md: use canonical contact email
  quangminh2402.dev@gmail.com (matches sibling n24q02m repos)
- CONTRIBUTING.md: clarify only feat:/fix: prefixes are accepted
  (enforced by commit-msg hook), not all Conventional Commit types

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

@n24q02m
n24q02m merged commit 9e6038f into main Jun 10, 2026
25 checks passed
@n24q02m
n24q02m deleted the fix/docs-audit-qwen3 branch June 10, 2026 03:38
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