[AI] fix: changelog.mdx #791
Closed
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1
The page uses bold label lines for sectioning (e.g., "New features:" and "Fixes:" at lines 16, 22, 29, 32, 42, 51, 56). The style guide forbids bolding whole lines/paragraphs and recommends using structure instead. Minimal fix: replace each bold label with a heading at the next level, for example, change "New features:" to "### New features" and "Fixes:" to "### Fixes".
Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#6-2-quotation-marks-and-emphasis
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1
Line 10 uses quotes for emphasis: “the "initial" version.” Quotes must be reserved for literal UI/log text, not emphasis. Minimal fix: remove the quotes: “the initial version.”
Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#6-2-quotation-marks-and-emphasis
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1
At line 20, link text “Includes” points to
/language/func/compiler-directives#%23pragma-versioninstead of the#includesection. Minimal fix: change the target to/language/func/compiler-directives#%23include. Broken/mismatched anchors are release‑blocking.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#severity-model-release‑blocking; https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#12-links-and-cross‑references
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1
At line 43, “multiline
asmstatements” links to/language/func/functions#multiline-asms, but the target heading is “### Multi-line asms” (hyphenated). Minimal fix: change the link to/language/func/functions#multi-line-asms.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#12-links-and-cross‑references
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1
At line 52, the link points to
/language/func/statements#try-catch-statements(plural, hyphenated). The actual heading is “##try...catchstatement”, whose anchor uses the ellipsis. Minimal fix: change to/language/func/statements#try%E2%80%A6catch-statement.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#12-links-and-cross‑references
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1
At line 53, the link points to
/language/func/built-ins#throwing-exceptions, which does not exist. The canonical anchor is “####throw_arg” →/language/func/built-ins#throw-arg. Minimal fix: update the link to/language/func/built-ins#throw-arg.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#12-links-and-cross‑references
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1
At line 19, link text “Semver pragmas” diverges from the canonical term used on the target page (“
#pragmaversion” and “semantic versioning (semver)”). Minimal fix: change link text to “#pragmaversion” (or “Pragma version (semver)”) to align with the reference.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#5-3-acronyms-and-terms; https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#12-1-link-text
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1
At line 18, the link text says “Extended string literals” but targets the “Compile-time built-ins” section. Minimal fix: change link text to “Compile-time built-ins” to match the referenced heading
/language/func/literals#compile-time-built-ins.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#12-1-link-text; https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#5-3-acronyms-and-terms
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1
Lines 33–36 use link text like “(#377)”. Link text must be descriptive; bare numbers are ambiguous out of context. Minimal fix: change to “(issue #377)”, “(issue #374)”, “(issue #370)”, and “(issue #375)” respectively, preserving the same URLs.
Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#12-1-link-text
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1
Release dates are formatted as “May 2022”, “Aug 2022”, “Oct 2022”, “Jan 2023” (lines 14, 27, 40, 49). Changelogs should use ISO format for dates. Minimal fix: change link text to ISO months, e.g., “2022-05”, “2022-08”, “2022-10”, “2023-01” (keep the same URLs).
Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#14-numbers-units-date-and-time
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1
Line 57 cites
load_unit(64)twice; the correct built-in isload_uint. Minimal fix: replace both instances withload_uint(64). Cross-doc evidence:load_uintis documented whileload_unitis not (see https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/built-ins.mdx?plain=1#built-ins-with-non-symbolic-names). This is an obvious typo based on identifier consistency.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#1-goals-and-principles-reader‑first-answer‑first
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1
Line 57: “after their usage” uses a less common noun form. The guide prefers common words. Minimal fix: change to “after their use”.
Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#5-2-plain-precise-wording
#pragmaversionhttps://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1#L19
The link text "Semver pragmas" doesn’t match the target section and the anchor is percent‑encoded (
#%23pragma-version), which doesn’t resolve. Use the target section’s actual anchor and align the term with the heading. Minimal fix: change to#pragmaversion.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#16.3 Links and anchors; https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#5.3 Acronyms and terms
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1#L29-L42–45,52–54
Bulleted “New features” items are fragments but end with periods, while earlier list items (lines 17–20) omit terminal punctuation. Minimal fix: remove the trailing periods from these fragment bullets for consistency.
Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#6-4-lists
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1#L4
noindexis set as a quoted string ("true"). The style guide uses boolean form (noindex: true). Minimal fix: change tonoindex: true.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#16-2-navigation-labels
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1#L17-L53
Internal links use root-absolute paths (
/language/…). The guide prefers relative links to avoid domain/path coupling. Minimal fix: drop the leading/language/func/where applicable, e.g., change/language/func/literals#constants→literals#constants.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#16-3-links-and-anchors
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1#L43
Visible text says “multiline
asmstatements” while the target section and prevailing usage use “multi-line”. Minimal fix: change the text to “multi-lineasmstatements”.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#terminology-and-naming
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/language/func/changelog.mdx?plain=1#L19
Generic concept “semver” is capitalized mid-sentence. Minimal fix: change link text to “semver pragmas”.
Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#general-casing-rules