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