Skip to content

docs: state platform support (Linux/macOS/Windows) - #238

Merged
dimitri-yatsenko merged 1 commit into
mainfrom
docs/platform-support-statement
Jul 27, 2026
Merged

docs: state platform support (Linux/macOS/Windows)#238
dimitri-yatsenko merged 1 commit into
mainfrom
docs/platform-support-statement

Conversation

@dimitri-yatsenko

Copy link
Copy Markdown
Member

⚠️ Do not merge until datajoint-python #1521 and #1522 land. This documents Windows as a CI-backed supported platform; the claim about the Windows unit-test leg is only accurate once #1522 (the unit-tests-windows job) merges, and the underlying file-path fix is #1521.

Records the decision to keep Windows a supported platform for DataJoint — including file-protocol object stores and garbage collection — backed by CI, rather than documenting it as unsupported. Consistent with the existing "supported == what we test in CI" framing (the DB version-support policy in database-backends.md, from #1497).

Change

Adds a Platform support section to how-to/installation.md (plus a Requirements line), stating what CI validates on each OS:

  • Full suite incl. DB integration on Linux (Python 3.10 & 3.14).
  • Unit suite additionally on Windows (Python 3.10 & 3.14) — covering file-protocol path handling and garbage collection (the class of bug in datajoint-python #1520).
  • macOS as a supported development platform.

Wording is deliberately precise about what runs where so it doesn't overclaim (Windows runs the unit suite, not the DB-backed integration tests).

Related

  • datajoint-python #1520 (bug), #1521 (fix), #1522 (Windows CI leg).

Records the decision that Windows is a supported platform for datajoint,
including file-protocol object stores and garbage collection, backed by CI.
Adds a Platform support section describing what CI validates on each OS,
mirroring the DB version-support-policy tone in database-backends.md.

Depends on datajoint-python #1521 (path fix) + #1522 (Windows CI leg).
@dimitri-yatsenko dimitri-yatsenko added the documentation Improvements or additions to documentation label Jul 23, 2026

@MilagrosMarin MilagrosMarin left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM — verified the three platform claims against CI config (Linux full suite via test.yaml:29 ubuntu-latest × py310/py314 × mysql 8.0/8.4; Windows unit suite matches #1522's unit-tests-windows job exactly; macOS "development platform" correctly reflects pixi platforms including osx-arm64 with no CI leg). Merge gate confirmed still active — #1520 closed, #1521/#1522 both open.

One nit: ## Platform support is sentence case, while every other ## in installation.md is Title Case (## Install DataJoint 2.0+, ## Verify Installation, ## Database Server, ## Requirements, ## Troubleshooting). Anchor resolves either way; just visible in the rendered TOC next to its siblings.

@dimitri-yatsenko
dimitri-yatsenko merged commit a54cd9c into main Jul 27, 2026
2 checks passed
@dimitri-yatsenko
dimitri-yatsenko deleted the docs/platform-support-statement branch July 27, 2026 16:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants