Редакционная политика
Правила источников, перевода, проверки, обновления и исправления материалов в независимой базе знаний Orca Guide.
Редакционная политика определяет, какие материалы публикуются в Orca Guide, как подтверждается информация и что происходит после сообщения об ошибке.
Приоритет источников
Для функций Orca основным источником считается официальная документация, затем открытый репозиторий продукта и воспроизводимое поведение актуальной версии приложения. Документация провайдеров используется для Claude Code, Codex, Cursor CLI и других сторонних инструментов.
Посты, сообщения в социальных сетях и ответы ИИ-моделей могут помочь найти направление, но не считаются достаточным подтверждением сами по себе.
Перевод и локальные дополнения
Перевод должен сохранять технический смысл исходника, команды, пути, ограничения и предупреждения. Непереводимые названия интерфейса можно оставить на языке приложения, если это помогает найти элемент.
Практический опыт русскоязычного сообщества публикуется отдельно от импортированных материалов либо явно помечается как локальное дополнение. Нельзя выдавать предположение или единичный результат за официальное поведение Orca.
Даты и ответственность
На странице отображается дата последнего изменения файла в Git. Она показывает свежесть публикации, но не гарантирует повторную ручную проверку продукта. Если материал проверен на конкретной версии Orca, это указывается в тексте отдельно.
В материалах ответственным указана редакция Orca Guide. Автора конкретного изменения можно найти в истории коммитов, поэтому проект не приписывает работу вымышленному человеку.
Исправления
Сообщения принимаются через GitHub Issues. Опасные команды, неверные инструкции по безопасности, утечки секретов и ссылки на вредоносные ресурсы исправляются раньше обычных стилистических ошибок.
После подтверждения ошибки редакция:
- исправляет текст и связанные ссылки;
- проверяет соседние страницы на тот же дефект;
- запускает проверку типов и production-сборку;
- публикует изменение с новой датой;
- при необходимости отвечает в исходной задаче.
История изменений не скрывается: предыдущая версия остаётся доступной в Git.
Генеративные инструменты
ИИ-инструменты можно использовать при подготовке черновика, поиске несогласованностей и технической проверке. Перед публикацией редактор проверяет источники, факты, структуру, ссылки, команды и заявления о продукте.
Массовая публикация однотипных страниц без самостоятельной пользы не допускается. Не создаются doorway-страницы, искусственные сравнения и FAQ-разметка только ради поискового сниппета.
Лицензии и приватность
Материал не должен включать секреты, закрытый код или персональные данные без правового основания. Внешние изображения и цитаты используются только в объёме, необходимом для объяснения, с указанием происхождения.
Если требуется предложить новый материал, используйте инструкцию для участников.
Частые вопросы
Как редакция выбирает источники?
Для фактов о продукте приоритет имеют официальная документация, репозиторий и проверяемое поведение актуальной версии.
Как отделяется факт от совета сообщества?
Официальное поведение подтверждается источником, а практические рекомендации формулируются как опыт и не приписываются команде Orca.
Что происходит при расхождении перевода с оригиналом?
Редакция сверяет термин, исправляет текст и при необходимости уточняет версию, к которой относится поведение.
Как рассматривается сообщение об ошибке?
Проверяется адрес страницы, спорный фрагмент, источник и воспроизводимость, после чего изменение вносится с понятной формулировкой.
Почему у статьи указана дата обновления?
Она помогает читателю оценить актуальность материала и понять, когда содержание проверяли в последний раз.