feat/fix(internal-infra): formatter updates

[novusnota]

A follow-up to #540 (MDX and Markdown formatter), and an an update of the mint package.

[github-actions]

Thanks for the updates across README and the guidebook docs. A few high‑severity link/style issues need fixes before this can merge.

Findings (4)

High (4)

[HIGH] Command uses undefined, non-angle-case placeholders

Location:

mintlify-ton-docs/README.md

Lines 49 to 51 in 529cf9a

	```shell
	npm run fmt:some FILENAME1 FILENAME2
	```

Description:
The command example uses bare placeholders (“FILENAME1 FILENAME2”) without angle brackets or first-use definitions, which increases copy/paste risk and ambiguity. The style guide requires <ANGLE_CASE> placeholders with immediate definitions.

Suggestion:

-```shell
-npm run fmt:some FILENAME1 FILENAME2
-```
+```shell
+npm run fmt:some <FILE_1> <FILE_2>
+```
+Define placeholders (first use):
+`<FILE_1>`, `<FILE_2>` — paths to files to format.

[HIGH] Empty href creates a broken link

Location:

mintlify-ton-docs/guidebook/more.mdx

Line 49 in 529cf9a

href=""

(also reported at guidebook/more.mdx?plain=1#L45-L50)

Description:
The “English” course card sets href="", which renders a non-functional link and blocks navigation. Broken anchors are classified as high severity in the style guide.

Suggestion:

-  <Card
-    title="English"
-    icon="flag-usa"
-    arrow="true"
-    href=""
-  />
+  {/* Removed temporarily: no English link available */}

-  <Card
-    title="English"
-    icon="flag-usa"
-    arrow="true"
-    href=""
-  />

--- a/guidebook/more.mdx
+++ b/guidebook/more.mdx
@@
-  <Card
-    title="English"
-    icon="flag-usa"
-    arrow="true"
-    href=""
-  />

[HIGH] URL shortener used for YouTube link

Location:

mintlify-ton-docs/guidebook/more.mdx

Lines 125 to 131 in 529cf9a

	<Columns cols={2}>
	<Card
	title="Crypto Networks and Why They Matter"
	icon="video"
	arrow="true"
	href="https://youtu.be/2wxtiNgXBaU"
	/>

Description:
A video card uses a youtu.be short URL. Shorteners are prohibited; links must be clean and canonical.

Suggestion:

-    href="https://youtu.be/2wxtiNgXBaU"
+    href="https://[REDACTED]/watch?v=2wxtiNgXBaU"

[HIGH] Invalid href in “Hack the TON” card

Location:

mintlify-ton-docs/guidebook/more.mdx

Line 203 in 529cf9a

<Card title="Hack the TON" icon="bug" arrow="true" href="TON Development with Tact">TON-based wargame inspired by The Ethernaut, played in the TON Virtual Machine. Each level is a smart contract that needs to be hacked. Our goal is to help you to learn how to develop safe TON smart contracts and build a thriving community around this craft.</Card>

Description:
The card sets href="TON Development with Tact", which is not a valid absolute or repo‑relative URL, resulting in a broken link. Broken anchors are classified as high severity; use a valid HTTPS or repo‑relative target.

Suggestion:

-  <Card title="Hack the TON" icon="bug" arrow="true" href="TON Development with Tact">TON-based wargame inspired by The Ethernaut, played in the TON Virtual Machine. Each level is a smart contract that needs to be hacked. Our goal is to help you to learn how to develop safe TON smart contracts and build a thriving community around this craft.</Card>
+  {/* TODO: add valid URL; temporarily removing broken link */}

-  <Card title="Hack the TON" icon="bug" arrow="true" href="TON Development with Tact">TON-based wargame inspired by The Ethernaut, played in the TON Virtual Machine. Each level is a smart contract that needs to be hacked. Our goal is to help you to learn how to develop safe TON smart contracts and build a thriving community around this craft.</Card>
+  <!-- TODO: Add a valid URL for “Hack the TON” before re-enabling this card. -->

--- a/guidebook/more.mdx
+++ b/guidebook/more.mdx
@@
-  <Card title="Hack the TON" icon="bug" arrow="true" href="TON Development with Tact">TON-based wargame inspired by The Ethernaut, played in the TON Virtual Machine. Each level is a smart contract that needs to be hacked. Our goal is to help you to learn how to develop safe TON smart contracts and build a thriving community around this craft.</Card>

[novusnota]

/review

[github-actions]

Thanks for the updates here. There’s one small but high‑severity doc style fix needed in README before merge.

Findings (1)

High (1)

[HIGH] Undefined placeholders in command example

Location:

mintlify-ton-docs/README.md

Lines 49 to 51 in a239e3b

	```shell
	npm run fmt:some <FILE_1> <FILE_2>
	```

Description:
The example introduces <FILE_1> and <FILE_2> without defining them on first use, which creates copy/paste ambiguity. This violates the style guide requirement to define angle‑case placeholders at first mention (see https://github.com/tact-lang/mintlify-ton-docs/blob/main/contribute/style-guide-extended.mdx?plain=1#L391-L400, https://github.com/tact-lang/mintlify-ton-docs/blob/main/contribute/style-guide-extended.mdx?plain=1#L581-L586, and https://github.com/tact-lang/mintlify-ton-docs/blob/main/contribute/style-guide-extended.mdx?plain=1#L393-L397).

Suggestion:
You can apply one of these fixes:

 ```shell
-npm run fmt:some <FILE_1> <FILE_2>
+npm run fmt:some <FILES...>

+Define placeholders (first use):
+<FILES...> — space-separated file paths to format.

```diff
 To check and fix formatting of some **selected** files, run:

 ```shell
 npm run fmt:some <FILE_1> <FILE_2>

+Define placeholders (first use):
+<FILE_1> — path to the first file to format.
+<FILE_2> — path to the second file to format.

```diff
 To check and fix formatting of some **selected** files, run:

 ```shell
 npm run fmt:some <FILE_1> <FILE_2>

+Define placeholders: <FILE_1>, <FILE_2> — paths to files you want to format.

[github-actions]

Install necessary dependencies: npm ci
Then, run this to fix formatting: npx remark -o --quiet --silently-ignore techniques/examples.mdx README.md contribute/snippets/index.mdx ecosystem/ton-connect/walletkit/native-web.mdx guidebook/more.mdx

[github-actions]

To fix the formatting issues:

1. Install necessary dependencies: npm ci
2. Then, run this command:

npx remark -o --quiet --silently-ignore techniques/examples.mdx README.md contribute/snippets/index.mdx ecosystem/ton-connect/walletkit/native-web.mdx guidebook/more.mdx

[anton-trunov]

formal approval