Кто отвечает за материал
Коллективный автор материалов Koddo — Редакция Koddo. Эта подпись означает, что редакция отвечает за выбор темы, структуру, факты и финальную публикацию.
Технического ревьюера называем по имени только после того, как он проверил финальную версию. Ревьюер проверяет код, технические утверждения и выводы. Если такого ревью не было, имя не публикуем и не подменяем проверку консультацией или должностью специалиста.
На что опираются утверждения
Сначала используем первичные официальные источники: документацию проекта, стандарты, спецификации, официальные примечания к выпускам и публичные данные владельца продукта. Вторичные источники добавляем для контекста, но не выдаём их пересказ за первичное доказательство.
Результаты экспериментов должны быть воспроизводимыми. Вместе с выводом указываем методику, входные данные, значимые настройки и ограничения. Если результат зависит от машины, нагрузки или выборки, говорим об этом прямо и не обобщаем один замер на все среды.
Среда и версии
В техническом материале есть поле «Среда и версии». В нём перечисляем всё, что влияет на воспроизведение: версию языка, рантайма, библиотеки, СУБД или браузера, операционную систему и значимые настройки. Если параметр не влияет на результат, не создаём ложную точность.
Как работают даты публикации
-
publishedAt— дата первой публикации. После выхода материала она не меняется. -
updatedAtпоявляется или меняется только после содержательной правки: нового вывода, изменённой методики, обновления кода, совместимости или фактов. -
Исправление опечатки, пунктуации, оформления или неработающей ссылки
не двигает
updatedAt.
Раздел «История изменений» добавляем только тогда, когда он помогает понять существенные ревизии материала. Рутинные редакторские правки в него не включаем.
Как сообщить об ошибке
Если вы нашли фактическую ошибку, невоспроизводимый пример или устаревшее утверждение, напишите на help@koddo.ru. Укажите ссылку на материал, спорный фрагмент и источник или шаги воспроизведения. Мы проверим сообщение. Если ошибка подтвердится, исправим материал; при содержательной правке обновим дату и, если это помогает читателю, историю изменений.