[AI] fix: how-to-deploy.mdx #805
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/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L8
“Introduction” is discouraged; headings should be unique and descriptive. For how‑to pages, prefer specific labels like “Goal” or “Overview.” Replace
## Introductionwith## Goal(or## Overview).Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#7.3-uniqueness-and-linkability; https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#9.2-how-to-guides-goal-oriented-procedures
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L16
Use structure (headings) instead of bold for section labels. Change
**Prerequisites**to a heading## Prerequisitesto match the recommended how‑to structure.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/contribute/style-guide-extended.mdx?plain=1#9.2-how-to-guides-goal-oriented-procedures
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L26
Headings must use sentence case. Change
## Step-by-Step Deployment Guideto## Step-by-step deployment guide.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#7.1-case-and-form
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L30
Apply sentence case in headings. Change
### 1. Prepare the Merkle Treeto### 1. Prepare the Merkle tree.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#7.1-case-and-form
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L34
Apply sentence case in headings. Change
#### Data Collectionto#### Data collection.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#7.1-case-and-form
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L40
Apply sentence case in headings. Change
#### Tree Generation Processto#### Tree generation process.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#7.1-case-and-form
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L53
Apply sentence case in headings. Change
#### Best Practicesto#### Best practices.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#7.1-case-and-form
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L59
Use sentence case with proper nouns only. Change
### 2. Deploy the Jetton Master Contractto### 2. Deploy the Jetton master contract.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#7.1-case-and-form
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L63-L151
Convert the following to sentence case:
#### Contract Requirements→#### Contract requirements#### Storage Extensions→#### Storage extensions#### Deployment Checklist→#### Deployment checklist### 3. Set Up Off-Chain Infrastructure→### 3. Set up off-chain infrastructure#### Merkle Tree Hosting→#### Merkle tree hosting#### Custom Payload API Implementation→#### Custom payload API implementation#### Performance Considerations→#### Performance considerations### 4. Configure Metadata→### 4. Configure metadata#### Required Metadata Fields→#### Required metadata fields#### Key Considerations→#### Key considerations## Development Tools and Utilities→## Development tools and utilitiesRule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#7.1-case-and-form
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L159-L208
Avoid repeated headings at the same nesting level to improve TOC/linkability. Rename to be specific:
#### Installation(TON Core section) →#### Installation (TON Core)#### Usage(TON Core section) →#### Usage (TON Core)#### Installation(Tonkeeper section) →#### Installation (Tonkeeper)#### Usage(Tonkeeper section) →#### Usage (Tonkeeper)Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#7.3-uniqueness-and-linkability
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L42-L107
All fenced blocks must specify a language. Add language tags:
```textfor the AirdropItem structure.```textfor the storage schema.```textfor the mixed endpoint/response example (or split intohttp+json).Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#10.1-general-rules
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L179-L213
Placeholders in commands must use
<ANGLE_CASE>and be defined on first use. Update and define:parse <input-boc> <output-file>→parse <INPUT_BOC> <OUTPUT_FILE>; then add definitions:<INPUT_BOC>— path to the input BoC file;<OUTPUT_FILE>— path to the output file.make_all_proofs <input-boc> <output-file>→make_all_proofs <INPUT_BOC> <OUTPUT_FILE>; definitions as above../bin/mintless-cli dump <airdrop-filename>→./bin/mintless-cli dump <AIRDROP_FILENAME>; then define<AIRDROP_FILENAME>— path to the airdrop file.Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#10.1-general-rules
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L10-L121
Spell out on first use, then use the acronym. Examples:
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/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L10
Technical sections must avoid marketing language. Replace “represent a revolutionary approach” and “comprehensive walkthrough” with neutral, task‑focused wording (e.g., “are a token distribution method” and “this guide provides a walkthrough”).
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/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L80
Tokens/identifiers must use code formatting. Change
merkle\_hashto`merkle_hash`(no escape needed inside code font).Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#6.3-code-styling
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L13
Internal links should be relative and point to the specific page. Change
[basic concepts](/standard/tokens/jettons/mintless)to[basic concepts](./overview)to link directly to the overview page within the same folder.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/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L105
Use structure instead of emphasis for section labels. Replace
**API Endpoints:**with a heading#### API endpoints.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/contribute/style-guide-extended.mdx?plain=1#7.1-case-and-form
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L107-L212
The endpoint uses "{address}"; placeholders must use angle brackets. Change to "GET /api/v1/proof/
" and add a short definition (e.g., " — target TON account address") immediately after the block. Also define placeholders used in commands on first use: "", "" (after line 178), and "" (after line 212). Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#severity-model-release-blocking; Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#101-general-rules.https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L105-L210
Bold label lines with colons should be headings for navigability and consistency. Minimal fixes:
Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#62-quotation-marks-and-emphasis; Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#71-case-and-form.
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L2-L3
For How‑to pages, set
title: "How to X"andsidebarTitle: "X", where X is sentence case. Change totitle: "How to deploy mintless jetton"andsidebarTitle: "Deploy mintless jetton"(unless "Jetton" is a proper noun here, but usage across pages favors lowercase). Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#162-navigation-labels.https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1
Tokens/identifiers must not be bolded. Minimal fix in “Key considerations”: use code font for field names:
mintless_merkle_dump_uri,custom_payload_api_uri.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/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1
On first mention, spell out the term, then the acronym in parentheses. Minimal fix: “Bag of Cells (BoC) file”.
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/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L93
Use the project’s preferred casing: “bag of cells” with lowercase words; “BoC” is uppercase. Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#b-banned-and-preferred-terms (TON‑specific casing). Minimal fix:
BoC (bag of cells) file.https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L6
Procedures that deploy contracts and send on‑chain messages can move funds and create irreversible state and require a Warning callout. Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#11-safety-critical-content-blockchain-specific and https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#a-admonition-levels-and-usage. Minimal fix: add an
<Aside type="danger" title="Warning — funds at risk">at the top, modeled on https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/how-to-mint.mdx?plain=1#L7–15, noting scope, rollback limits, and advising testnet first.https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L130
Prefer internal docs when available. Replace the external TEP link with the internal metadata page. Minimal fix: change link target to
/standard/tokens/metadata(TEP link may remain as a secondary reference if necessary).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/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L18
“Before starting the deployment process, ensure you have:” is wordy throat‑clearing. Minimal fix: change to “You need:”. Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#5-7-avoid-tautology-pleonasm-throat-clearing-and-circular-references
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L67
When an internal docs page exists, link it first. Minimal fix: add an internal link to the Mintless Jetton overview alongside the TEP reference (e.g., “Ensure compatibility with the Mintless Jetton overview and TEP‑177”). Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#12-2-what-to-link-and-what-not
https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L13
Link text must be descriptive and meaningful out of context. Minimal fix: change
[basic concepts](/standard/tokens/jettons/mintless)to[Mintless Jetton overview](/standard/tokens/jettons/mintless/overview). Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#12-1-link-texthttps://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/standard/tokens/jettons/mintless/how-to-deploy.mdx?plain=1#L2
The page title should use sentence case and preserve proper nouns. Use the canonical form “Mintless Jetton” as in the overview. Minimal fix: change
title: "How to deploy mintless Jetton"totitle: "How to deploy Mintless Jetton"andsidebarTitle: "Deploy mintless Jetton"(line 3) tosidebarTitle: "Deploy Mintless Jetton". Rule: https://github.com/tact-lang/mintlify-ton-docs/blob/53b6c23461988d04871b01bac537f21fbd21f860/contribute/style-guide-extended.mdx?plain=1#16-1-how-to-frontmatter-pattern