Editing the Manual

You can modify the manual by editing local text files. These files are kept in sync with those online via a repository, based on this the server will update the online manual.

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.

Обновление

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

svn update

Написание

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

Be sure to check the Руководство по стилю написания for conventions and Руководство по стилю оформления to learn how to write in the reStructuredText markup language.

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

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

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

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

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

Getting Help/Answers

If you are in doubt about functionality that you wish to document, you should pose your questions to the Blender developers responsible for that area or ask at the unofficial user support channel in the #docs or #blender-coders channel in Blender Chat.

Blender itself has a system of module owners with developer and artist members who are responsible for the design and maintenance of the assigned Blender areas. See the module owners page for more information.

Предпросмотр

Для просмотра ваших изменений, соберите руководство по данной инструкции. Помните, что вы можете собирать только ту главу, которую вы только что редактировали, чтобы процесс шёл быстрее. Откройте сгенерированные внутри папки build/html файлы .html в своём браузере, либо обновите страницу, если они уже там открыты.

Загрузка

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