Conversation
laviniat1996
added
the
scope: api
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
| - **TonLib types** (e.g. `raw.fullAccountState`, `tvm.cell`) come from the [TonLib TL schema](https://github.com/ton-blockchain/ton/blob/master/tl/generate/scheme/tonlib_api.tl), the type definition language used by the C++ library powering this API. | ||
| - **Extended types** (prefixed with `ext.`) are added by TON Center to provide parsed, developer-friendly representations not available in the base TonLib schema. |
There was a problem hiding this comment.
[HIGH] Non-permalink TL schema reference and marketing-style language
The overview bullet links to the TonLib TL schema using the moving master branch (https://github.com/ton-blockchain/ton/blob/master/tl/generate/scheme/tonlib_api.tl) on a normative reference page. The style guide’s stable permalink rule requires versioned or permanent URLs for normative code references and forbids moving targets like master or main when a versioned URL exists. The adjacent bullet also describes extended types as “developer-friendly representations”, which is a subjective, marketing-style adjective banned by the style guide in technical sections. Together, these issues reduce reproducibility and undermine the neutral, factual tone expected for reference documentation.
| - **TonLib types** (e.g. `raw.fullAccountState`, `tvm.cell`) come from the [TonLib TL schema](https://github.com/ton-blockchain/ton/blob/master/tl/generate/scheme/tonlib_api.tl), the type definition language used by the C++ library powering this API. | |
| - **Extended types** (prefixed with `ext.`) are added by TON Center to provide parsed, developer-friendly representations not available in the base TonLib schema. |
Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!
2 participants
closes #1870
Add a new page with details about tonlib types.
TonLib types are the low level data structures defined by TON’s core client library (TonLib) that describe how blockchain entities like accounts, transactions, messages, and cells are represented and transmitted.