From a1e13ee45ec515792de43939d3b48ec54ee097f7 Mon Sep 17 00:00:00 2001 From: Gusarich Date: Mon, 22 Sep 2025 19:51:34 +0300 Subject: [PATCH] feat(styleguide): make target audience more clear --- contribute/style-guide.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/style-guide.mdx b/contribute/style-guide.mdx index 8e05ad0d..6be2f354 100644 --- a/contribute/style-guide.mdx +++ b/contribute/style-guide.mdx @@ -7,11 +7,11 @@ This guide covers the basics: how to structure pages, write examples, and keep d ## Write for the reader +* Default audience: experienced software developers new to blockchain. Explain TON-specific concepts. Do not re-teach general programming. This keeps pages focused. * Be answer‑first. Start with what the reader will achieve, what they need, and the steps. This shortens time to success. * Lead with a working example. Show a copy‑pasteable snippet early and the expected output. This shows it works. * Use a neutral, precise tone. Write in present tense, active voice, and second person (“Run the node”). This makes actions clear. * Keep it scannable. Use short sections and paragraphs, clear headings, lists, and tables. Most readers skim to find the next action. -* Assume developers are new to blockchain. Don’t re‑teach generic skills unless a TON‑specific nuance requires it. This keeps pages focused. ## Page types