Editing the 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.
Обновление
Firstly, make sure that your local copy of the manual is up to date with the online repository using:
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.
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.
Предпросмотр
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.
Загрузка
Когда вы будете довольны вашими изменениями, вы можете загрузить их, чтобы они появились в онлайн-руководстве. По первой вы будете делать это через отправку заплаток, чтобы кто-нибудь смог отрецензировать ваши изменения и дать вам обратную связь. Спустя некоторое время вы сможете фиксировать свои изменения напрямую. Более подробно этот процесс описан в следующем разделе.