<!-- page:68344 -->
# Как писать вики

Вики помогает читателю увидеть связи между идеями: что относится друг к другу, что из чего следует и где действуют исключения. Эти связи выражает её структура, поэтому принципы ниже стоят выше любой практики, построенной на них; [процесс правки](page:68369) — то, как правка их сохраняет.

<!-- block:68471 -->
## Качества

<!-- block:68485 -->
### Компактность

Вики компактна. Её читают много раз, поэтому каждое лишнее слово отнимает время и прячет закономерности: предложения, без которого смысл не меняется, в ней нет.

<!-- block:68486 -->
### Расположение — это утверждение

Родитель узла говорит, к чему он относится; соседние узлы — с чем его можно сравнить. Неправильно расположенный узел создаёт неверное представление о связях, даже когда его текст точен.

Поэтому каждый узел стоит под той темой, где читатель стал бы его искать, а каждый раздел существует потому, что его иерархия помогает читателю, а не ради шаблона.

<!-- block:68487 -->
### Вики не спорит сама с собой

Каждый факт изложен в одном месте со своим адресом, а остальная вики ссылается на него. Два места, где сказано одно и то же, расходятся после правки одного из них, и читатель поступает по тому, которое нашёл первым.

<!-- block:68472 -->
## Поддержание актуальности

<!-- block:68488 -->
### Вики устаревает по трём причинам

Вики устаревает, когда меняются факты, появляются новые исключения или меняется понимание того, как связаны темы. В актуальной вики факт, его граница или структура обновлены той самой правкой, которая вскрыла изменение.

<!-- block:68489 -->
### Вики проверяют чтением

Проверки ловят частые ошибки, но не могут показать, что страница понятна своему читателю. Страница закончена, когда она хорошо читается целиком — так, как прочтёт её читатель, — и её проверил второй читатель.

---

## Links here

- [Первые шаги](page:68357)
- [Правка вики](page:68369)
- [Руководство Wikilayer](/smee-again/wikilayer-howto/ru)

---

[All pages](https://wikilayer.org/smee-again/wikilayer-howto/ru/index.md)
