Skip to content

Studio: tighten the comments added by the OpenAI model-admission work - #7501

Merged
danielhanchen merged 1 commit into
mainfrom
chore/studio-comment-reduction
Jul 27, 2026
Merged

danielhanchen merged 1 commit into
mainfrom
chore/studio-comment-reduction

Conversation

@danielhanchen

Copy link
Copy Markdown
Member

Comment-only follow-up to #7454.

That change carried 523 comment lines, many of them three and four line preambles where one line says the same thing. This collapses them and drops the ones restating what the code already says.

Net 77 lines removed (306 insertions, 383 deletions) across 17 files.

Scope

Limited to comments #7454 itself introduced. The files it touched hold roughly 3,761 comments in total; everything predating that commit is untouched. Verified mechanically: every removed line is one #7454 added.

What was kept

Compressed, never dropped, since these are the only written record of decisions a naive reimplementation would undo:

  • the normcase before-versus-after Windows separator trap in _norm_path
  • the innermost-indexed-model rule that stops nested directories reading as resident
  • why an HTTPException in the admission check is a decision, not a failure to decide
  • that only an explicit False is anonymous to huggingface_hub, while None borrows the server owner's cached login
  • the fail-closed tri-state custom-code gate
  • the specific regression each test was written for

Verification

  • comment_tools.py check --strip-docstrings: 17/17 files comments-only, so the code is provably unchanged
  • Backend CI command: 10337 passed, 0 failed
  • tsc -b: clean
  • frontend contract tests: 15 passed, no assertion changes needed

Comment-only follow-up to #7454. That change carried 523 comment lines, many of
them three and four line preambles where one line says the same thing. This
collapses them and drops the ones restating what the code already says, for a
net 77 lines.

Scope is limited to comments #7454 itself introduced. The files it touched hold
about 3,761 comments in total; the rest predate it and are untouched, verified
by checking that every removed line is one that commit added.

Nothing that records why a non-obvious decision was made was dropped, only
compressed. Still stated: the normcase-before-versus-after Windows separator
trap, the innermost-indexed-model rule for nested directories, an HTTPException
being a decision rather than a failure to decide, that only an explicit False is
anonymous to huggingface_hub while None borrows the server owner's login, the
fail-closed tri-state custom-code gate, and the regressions each test was
written for.

Code is provably unchanged: comment_tools.py check reports 17/17 files
comments-only. Backend CI command 10337 passed, 0 failed. tsc -b clean.
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@danielhanchen
danielhanchen merged commit 06829c2 into main Jul 27, 2026
49 of 50 checks passed
@danielhanchen
danielhanchen deleted the chore/studio-comment-reduction branch July 27, 2026 12:59
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