crosslink Tvm PDF

[fakela]

This whitepaper has only one reference cited:
[1]: N. Durov, “Telegram Open Network,” 2017

This reference is linked in only three sections:

• Section 1.1.3 – [1, 2.5.14]
• Section 3.1.10 – [1, 2.5.14]
• Section 4.1.10 – [1, 5]

I have attached the following external link to the reference entry N. Durov, “Telegram Open Network,” 2017 for easier access:
https://www.editionmultimedia.fr/wp-content/uploads/2019/10/Telegram-Open-Network-2017.pdf

The 2017 PDF is not hosted on Mintlify (only the 2020 version is) hence the need for the external link. Also, this pdf does not crosslink with other whitepapers currently available on Mintlify.

Closes issue: #560

[github-actions]

Thanks for the updates to the TON/TVM docs. A couple of high‑severity fixes are needed to align links with our style and ensure readers land on authoritative, precise sources.

Findings (2)

High (2)

[HIGH] Conflated link text and incorrect anchor target

Location:

mintlify-ton-docs/ton/tvm.mdx

Line 565 in 873a171

As described in [1, 2.5.14](#reference-1), all the data used by the TON Blockchain, including the blocks themselves and the blockchain state, can be represented—and are represented—as collections, or “bags”, of cells.

Description:
The link text “[1, 2.5.14]” combines a citation index with a section number but points only to #reference-1, leaving “2.5.14” unlinked. This conflicts with guidance to use descriptive link text and to deep‑link to the exact section that contains the cited fact.

Suggestion:
Split into two links and deep‑link to the specific section.

-As described in [1, 2.5.14](#reference-1), all the data used by the TON Blockchain, including the blocks themselves and the blockchain state, can be represented—and are represented—as collections, or “bags”, of cells.
+As described in [1](#reference-1) and [2.5.14 — Everything is a bag of cells](/ton/ton#2-5-14-everything-is-a-bag-of-cells-philosophy), all the data used by the TON Blockchain, including the blocks themselves and the blockchain state, can be represented—and are represented—as collections, or “bags”, of cells.

[HIGH] External non‑authoritative PDF link where official local copy exists

Location:

mintlify-ton-docs/ton/tvm.mdx

Line 4518 in 873a171

<a id="reference-1"></a> [1] N. Durov, [*Telegram Open Network*](https://www.editionmultimedia.fr/wp-content/uploads/2019/10/Telegram-Open-Network-2017.pdf), 2017.

Description:
Reference [1] links to a third‑party mirror (editionmultimedia.fr) instead of the official/local copy. The style guide calls for authoritative sources and canonical URLs, and a local canonical copy exists at /resources/pdfs/ton.pdf.

Suggestion:
Point the reference to the local canonical PDF.

-<a id="reference-1"></a> [1] N. Durov, [*Telegram Open Network*](https://www.editionmultimedia.fr/wp-content/uploads/2019/10/Telegram-Open-Network-2017.pdf), 2017.
+<a id="reference-1"></a> [1] N. Durov, [*Telegram Open Network*](/resources/pdfs/ton.pdf), 2017.

[fakela]

PS: Please ignore github actions comment as it doesn't fit current scope

[verytactical]

Please use <Aside> or <Warning>. Scrolling down to footnote is error-prone and implemented incorrectly in mintlify.

[fakela]

@reveloper I am changing this from footer to using <Aside>

[fakela]

@verytactical The <Aside> added for TVM

[verytactical]

As far as I know there was a previous discussion (that didn't involve me) that there should be an example of crosslinks first, and after that we'd expand it to the rest of whitepapers.

Let's postpone any changes here until we agree on the way crosslinks should be done, and #627 is merged.