# Примеры зачастую полезнее объяснений

DevFeed: [Примеры зачастую полезнее объяснений](<https://devfeed.tech/articles/article-24785.md>)

Original publisher: [Read original article](<https://dev.cheremin.info/2021/08/blog-post_15.html>)

Author: Ruslan Cheremin (noreply@blogger.com)

Published: 2021-08-15T09:30:00Z

Content type: opinion

Language: ru

Sources: [\>рабочие заметки](<https://devfeed.tech/sources/source-2.md>)

Topics: [документация](<https://devfeed.tech/topics/tag-dc23c7266507.md>)

Tags: [examples](<https://devfeed.tech/tags/examples.md>), [tag-dc23c7266507](<https://devfeed.tech/tags/tag-dc23c7266507.md>)

## AI overview

The author argues that well-designed examples can make technical documentation easier to understand and more practically useful than lengthy explanations. Examples can orient readers, help solve concrete problems, and potentially reduce the cost of creating and maintaining documentation.

## Source excerpt

Я тут осознал, что сильно недооценивал роль примеров (examples) для технической документации. Документация очень сильно выигрывает от хороших примеров. Продуманные примеры могут быстро сориентировать читателя - ввести в курс дела, и облегчить понимание более детального описания. Более того, хорошо подобранные примеры способны сходу предоставить читателю (= пользователю) решение конкретной