Редактирование руководства

Вы можете изменять руководство, редактируя локальные текстовые файлы. Эти файлы синхронизируются с файлами в хранилище на сервере, на основе которых собирается онлайн-руководство.

The manual is written in the reStructuredText (RST) markup language and can be edited using a plain text editor. For a local preview, you convert (build) the manual source files from RST into HTML web pages.

Обновление

Во-первых, убедитесь, что ваша локальная копия руководства обновлена до последней версии онлайн-репозитория, используя:

make update

Написание

Теперь вы можете редактировать файлы документации, расположенные в папке manual, вашим любимым текстовым редактором, поскольку они являются обычными текстовыми файлами с расширением .rst.

Обязательно ознакомьтесь с Руководство по стилю написания для условных обозначений и Руководство по стилю оформления, чтобы узнать, как писать на языке разметки reStructuredText.

Счастливой писанины!

Большие изменения

Если вы собираетесь добавить или полностью переписать раздел, не забудьте тщательно проверить, а не существует ли он уже. В некоторых местах документация несколько дезорганизована, так что разделы могут повторяться или располагаться в странных местах. В случае, если вы найдёте дубликат или раздел не на своём месте, создайте задачу, объясняющую проблему, и постарайтесь включить в неё ревизию (с фактическими изменениями).

Перед тем, как выполнить любое нетривиальное редактирование (например, перемещение каталогов), вам следует уточнить у того, кто поддерживает руководство, согласуется ли такое изменение с концепцией руководства. Это позволит использовать ваше время и усилия наиболее эффективным образом. В противном случае, ваши изменения могут быть отклонены, либо потребуют время на проведение длительного ревью. Например, другой участник проекта уже работает над разделом, который вы собираетесь изменить, или раздел планируется удалить, либо обновить согласно плановым изменениям в Blender.

Своевременная и частая коммуникация между участниками является ключом к продуктивному окружению, усилия людей не распыляются и в результате всё идёт только на пользу руководству по Blender.

Получение помощи/ответов

Если у вас есть сомнения относительно функциональности, которую вы хотите задокументировать, вы должны задать свои вопросы разработчикам Blender, ответственным за эту область, или задать их на неофициальном канале поддержки пользователей в канале #docs или #blender-coders в чате Blender.

Сам Blender имеет систему владельцев модулей с разработчиками и художниками, которые отвечают за дизайн и обслуживание назначенных областей Blender’а. См. страницу владельцев модулей для получения дополнительной информации.

Предварительный просмотр (preview)

To view your changes, build the manual as instructed. Keep in mind that you can also build only the chapter you just edited to view it quickly. Open the generated .html files inside the build/html folder using your web browser, or refresh the page if you have it open already.

Загрузка

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