chore: v0.1.5 release (PyPI debut + CHANGELOG + PRE-PYPI strip)

[ayhammouda]

Summary

PR #3 of the v0.1.5 launch wave. Three changes that go together:

1. Version bump 0.1.4 → 0.1.5 across the three lockstep files release.yml enforces:
   • pyproject.toml:7 (project version)
   • server.json:11 (top-level version)
   • server.json:17 (packages[0].version for MCP Registry)
   • plus uv.lock (the matching lockfile bump)
2. CHANGELOG.md created with the v0.1.5 entry following Keep-a-Changelog format. Documents the PyPI debut, the positioning anchor, the phase-9/10/11 backlog, and the dropped rename decision.
3. README.md PRE-PYPI strip: 11 <!-- PRE-PYPI --> fenced regions removed (18 GitHub-source install URL references). README now leads with the canonical uvx python-docs-mcp-server install path everywhere.

Verified locally

• ✅ uv build produces python_docs_mcp_server-0.1.5-py3-none-any.whl + .tar.gz
• ✅ synonyms.yaml present in wheel (release.yml check passes)
• ✅ Clean-venv install: python-docs-mcp-server --version reports 0.1.5
• ✅ pytest -q — 269/269 tests passing
• ✅ Zero PRE-PYPI markers remain in README; zero uvx --from git+ or pipx install git+ references

What lands after this PR merges

Tagging v0.1.5 will trigger .github/workflows/release.yml:

1. build — verifies version triple lockstep, runs lint/type/test, builds wheel + sdist
2. publish — Trusted Publishing to PyPI (https://pypi.org/project/python-docs-mcp-server/) with Sigstore attestations
3. publish-mcp-registry — mcp-publisher updates the MCP Registry entry
4. github-release — creates the v0.1.5 GitHub Release with artifacts

The PyPI Trusted Publisher is already configured (Repository: python-docs-mcp-server, Workflow: release.yml, Environment: pypi) — confirmed by v0.1.4 having successfully published with attestations.

Test plan

• CI green (ci.yml, security.yml, codeql.yml)
• grep '^version' pyproject.toml returns version = "0.1.5"
• jq .version server.json and jq '.packages[0].version' server.json both return "0.1.5"
• CHANGELOG.md renders cleanly on GitHub
• After merge: git tag v0.1.5 && git push origin v0.1.5 → release.yml runs all 4 jobs green → uvx python-docs-mcp-server --version returns 0.1.5 from a clean shell

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation

  • Added CHANGELOG to document release history and track version updates
  • Simplified installation instructions with clearer, more concise setup steps
  • Streamlined configuration examples for popular MCP clients including Claude Desktop, Cursor, and Codex
  • Improved diagnostics and troubleshooting sections with updated guidance
  • Cleaned up outdated setup information throughout documentation

• Chores

  • Version bumped to 0.1.5

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 8807f0fc-58be-445a-9e2c-0476145a4f01

📥 Commits

Reviewing files that changed from the base of the PR and between 020a253 and d9fa5f7.

⛔ Files ignored due to path filters (1)

• uv.lock is excluded by !**/*.lock

📒 Files selected for processing (4)

• CHANGELOG.md
• README.md
• pyproject.toml
• server.json

---

📝 Walkthrough

Walkthrough

This PR releases version 0.1.5 by bumping version identifiers across configuration files, introducing release notes documenting the PyPI debut and specification additions, and simplifying README installation and configuration guidance by removing pre-PyPI GitHub-source instructions.

Changes

Version 0.1.5 Release

Layer / File(s)	Summary
Version bump in configuration files pyproject.toml, server.json	Package version incremented from 0.1.4 to 0.1.5 in both build configuration and package registry metadata.
Release notes and changelog CHANGELOG.md	New changelog documents 0.1.5 additions (PyPI debut, .planning/phases/ specs), changes (README/config realignment), removals (pre-PyPI fenced regions), and preservation of 0.1.4 historical context.
README post-PyPI instruction consolidation README.md	Install, first-run build-index, client configuration (Claude Desktop, Cursor, Codex), diagnostics, and troubleshooting sections simplified by removing pre-PyPI GitHub-source variants and lead-ins, keeping only post-PyPI uvx-based workflows.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• ayhammouda/python-docs-mcp-server#26: Overlaps in README pre-PyPI and configuration sections; PR #26 renames repository URLs while this PR removes those pre-PyPI blocks entirely.

Poem

🐰 A version hop, from four to five,
PyPI dawn makes docs alive!
Pre-build ghosts swept away so clean,
Now uvx commands take the scene.
Release notes penned, the changelog shines—
thump-thump celebrates these aligned designs! ✨

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/pypi-v015

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}