Skip to content

docs(chart,tuner): correct docstrings after all-cores and axis-keep - #698

Merged
kirillDevPro merged 1 commit into
mainfrom
docs/docstrings-allcores-axis
Sep 22, 2026
Merged

kirillDevPro merged 1 commit into
mainfrom
docs/docstrings-allcores-axis

Conversation

@kirillDevPro

Copy link
Copy Markdown
Collaborator

What & why

An audit of the comments added by #696 and #697 found ten that no longer matched the code — most notably the corner-caption count described as the same test as pane_admits_record (it is the owner-pane gate plus a set wider than the owner), and the report-axis observer's docstring contradicting its own joint-suggestion exception.

Comment and docstring lines only: every changed line is a // comment or blank.

How to verify

cargo fmt --all -- --check and cargo test -p moon-ui-gpui --test theme_contract (360 pass) — the static contracts read sources as text, comments included.

An audit of the comments added by the all-cores chart history and the
tuner's axis-keep change found ten that no longer matched the code:

- the corner-caption count was described as the same test as
  pane_admits_record; it is the owner-pane gate plus a set wider than
  the owner, not the per-record contains check;
- None on the admitted core set was described as the state of every
  panel; a chart load now stores Some even with the flag off, and None
  means an unpublished set, a cleared target or the frozen Trade window;
- the report-axis observer's Returns line said every in-flight read
  identity retires, contradicting the joint-suggestion exception in the
  same docstring, and the kept search was said to finish on the axis it
  started on, which holds only once the scan has materialized its sample.

Comment and docstring lines only; no code changes.
@kirillDevPro
kirillDevPro merged commit 75af100 into main Sep 22, 2026
8 checks passed
@kirillDevPro
kirillDevPro deleted the docs/docstrings-allcores-axis branch September 22, 2026 18: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