Skip to content

Commit c4a3bd9

Browse files
committed
docs: define cluster and pool manager ownership
Inventory lifecycle writers and propose manager admission, stale-result disposal, callback reentry and shutdown before runtime implementation. Keep admission capacity, reactor-call compatibility, and validation workloads and budgets subject to recorded agreement. Map staged migration and deterministic regression gates to issues #1257 through #1263 so lifecycle changes can be checked against the proposed ownership contract. Keep the developer guide beside contributor docs. Refs #1256
1 parent b4aa97b commit c4a3bd9

2 files changed

Lines changed: 974 additions & 1 deletion

File tree

‎CONTRIBUTING.rst‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,15 @@ Design and Implementation Guidelines
2727
- Legacy ``cqlengine`` has varying degrees of overreaching client-side validation. Going forward, we will avoid client validation where server feedback is adequate and not overly expensive.
2828
- When writing tests, try to achieve maximal coverage in unit tests (where it is faster to run across many runtimes). Integration tests are good for things where we need to test server interaction, or where it is important to test across different server versions (emulating in unit tests would not be effective).
2929

30+
Manager architecture
31+
--------------------
32+
The `cluster and pool manager ownership contract <MANAGER_OWNERSHIP.rst>`_
33+
records the proposed internal architecture, migration stages, regression
34+
coverage and validation budgets for lifecycle changes. The workloads, budgets
35+
and measurement procedure require recorded agreement before runtime
36+
implementation. The contract describes a development target rather than
37+
released runtime behavior.
38+
3039
Optional NumPy imports
3140
----------------------
3241
Ordinary driver imports must not import NumPy, even when it is installed.
@@ -195,7 +204,8 @@ when the working tree has changes; use ``--worktree`` to plan those changes.
195204
Selection follows these rules:
196205

197206
* Documentation/support-only changes select no driver tests. This includes
198-
``docs/``, Markdown files, ``CONTRIBUTING.rst``, ``CHANGELOG.rst``, ``LICENSE``,
207+
``docs/``, Markdown files, ``CONTRIBUTING.rst``,
208+
``CHANGELOG.rst``, ``LICENSE``,
199209
``.gitignore``, ``.gitattributes``, ``.github/dependabot.yml``, and the two
200210
documentation workflows. Applicable docs builds and release-note
201211
classification continue.

0 commit comments

Comments
 (0)