Skip to content

docs: fix stale test and type-check paths in CONTRIBUTING.md#49

Closed
aeonbilal wants to merge 1 commit into
cdeust:mainfrom
aeonbilal:docs/fix-contributor-paths
Closed

docs: fix stale test and type-check paths in CONTRIBUTING.md#49
aeonbilal wants to merge 1 commit into
cdeust:mainfrom
aeonbilal:docs/fix-contributor-paths

Conversation

@aeonbilal

Copy link
Copy Markdown

While following the contributor setup on a fresh clone, I hit a few paths in CONTRIBUTING.md that don't resolve:

  • Type-check: mypy --strict src/cortex/ — there's no src/cortex/. pyproject.toml sets packages = ["mcp_server"], so it's mypy --strict mcp_server/.
  • Tests: pytest tests/unit|integration|benchmarktestpaths = ["tests_py"], and the suites live under tests_py/ (tests_py/integration, tests_py/benchmarks, …). Updated the examples to real subdirectories and realigned the comments.

Docs-only, no behavior change.

Two more references look stale but I left them alone since I wasn't sure of the intended target: the "Adding an MCP tool" step points at docs/MCP-TOOLS.md, and "Modifying retrieval signals" points at benchmarks/results.md — neither is in the tree (there's a benchmarks/results/ directory). Glad to follow up if you point me at the right spots.

The documented contributor commands point at directories that do not
exist on a fresh clone:

- `mypy --strict src/cortex/` -> there is no `src/cortex/`; pyproject sets
  `packages = ["mcp_server"]`, so the path is `mcp_server/`.
- `pytest tests/{unit,integration,benchmark}` -> `testpaths = ["tests_py"]`
  and the suites live under `tests_py/` (`tests_py/integration`,
  `tests_py/benchmarks`, ...).

Docs-only: corrected the paths to match pyproject.toml and the tree, and
realigned the comment column.
@cdeust

cdeust commented May 31, 2026

Copy link
Copy Markdown
Owner

Closing — not aligned with current project direction.

@cdeust cdeust closed this May 31, 2026
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.

2 participants