DocumentationProject
ActivePublic

Description

Blender Documentation (latest manual build)

Welcome to the Blender User Documentation project. We are actively searching for contributors and documentation module owners.
This project aims at replacing and updating the current Blender Manual.

The Blender Manual is written using reStructuredText (RST) and is built with Sphinx.

If you want to start contributing or want to have a look at the manual, here we have some instructions.

How to build & edit the docs locally

Before you start contributing it may be helpful to read the style guides which give instructions on how to write with RST and some goals of the manual.

Now that you are familiar with the process, you can get setup, edit, and contribute your changes by following these links:

  1. Install
  2. Build
  3. Edit
  4. Build again
  5. Patch or Commit
NOTE: We realize this may be intimidating if you're not familiar with Subversion or making patches, you may also submit the modified file as a Phabricator task, or mail the bf-docboard mailing list.

Links

Manual Docs: Manual/About (the process for editing the manual).
Source Files: Manual Repository (subversion repository).
Mailing List: bf-docboard
Administrators: @Aaron Carlisle (Blendify) @Francesco Siddi (fsiddi)


Documentation Team

The coordination of the Blender Manual is run by a set of Administrators and Section Owners:

The Administrators are responsible for managing the whole project and infrastructures. (listed above)

Similar to the Blender Module Owners, the Section Owners are responsible for a given section, reviewing patches for it, giving feedback and keeping up to date with Blender development in that area.

SectionSection Owners
Animation(none yet)
Composite Nodes(none yet)
Data System(none yet)
Editors(none yet)
Sequencer@Aaron Carlisle (Blendify)
Game Engine(none yet)
Getting Started(none yet)
Grease Pencil(none yet)
Modeling(none yet)
Modifiers(none yet)
Motion Tracking(none yet)
Physics(none yet)
Rendering(none yet)
Rigging(none yet)
User Preferences(none yet)
Images(none yet)
Pipeline@Francesco Siddi (fsiddi)
NOTE: Since the documentation project is still new, there are currently not many official Section Owners. If you are interested in becoming a Section Owner, please contact us on the bf-docboard mailing list.

Translations

For translations, we use Sphinx’s internationalization package. To get started see https://docs.blender.org/manual/en/dev/about/contribute/index.html#translations

Links

Source Files: Translation's Repository (subversion repository).
Mailing List: bf-docboard
Administrators: @Aaron Carlisle (Blendify) , @Francesco Siddi (fsiddi)

NOTE: If you are a new translator who wants to start translating a new language that is not listed below send and email to the bf-docboard and we would be glad to set it up for you.

Recent Activity

Today

Ryan Birmingham (birm) claimed T50792: Node Editor Docs Mute and Detach Unfinished.
Mon, Feb 27, 4:37 AM · Documentation
Ryan Birmingham (birm) claimed T50791: 3d cursor "Usage" Header is todo.
Mon, Feb 27, 4:37 AM · Documentation
Ryan Birmingham (birm) added a comment to T50791: 3d cursor "Usage" Header is todo.

Self assigning; I'll follow the procedures here (https://www.blender.org/manual/about/contribute.html#submit-patches)

Mon, Feb 27, 4:37 AM · Documentation
Ryan Birmingham (birm) added a comment to T50792: Node Editor Docs Mute and Detach Unfinished.

Self assigning; I'll follow the procedures here (https://www.blender.org/manual/about/contribute.html#submit-patches)

Mon, Feb 27, 4:36 AM · Documentation
Ryan Birmingham (birm) created T50792: Node Editor Docs Mute and Detach Unfinished.
Mon, Feb 27, 4:33 AM · Documentation
Ryan Birmingham (birm) created T50791: 3d cursor "Usage" Header is todo.
Mon, Feb 27, 4:31 AM · Documentation

Thu, Feb 23

Bastien Montagne (mont29) added a comment to T50466: Relocation of the documention (final solution).

So, finally found time to update API doc layout, should now match what we decided above.

Thu, Feb 23, 10:34 PM · Infrastructure: Websites, Documentation

Wed, Feb 22

Aaron Carlisle (Blendify) closed D2522: Api docs: use new urls by committing rB99947e2943b5: Use new api doc links.
Wed, Feb 22, 5:23 PM · BF Blender, Infrastructure: Websites, Documentation
blend-it (blend-it) added a comment to T42765: IT translation.

I don't think so, but it's your choice...

Wed, Feb 22, 5:00 PM · Documentation, Translations
blend-it (blend-it) edited the description of T42765: IT translation.
Wed, Feb 22, 4:56 PM · Documentation, Translations
Bastien Montagne (mont29) accepted D2522: Api docs: use new urls.

LGTM

Wed, Feb 22, 4:21 PM · BF Blender, Infrastructure: Websites, Documentation
Lukas Stockner (lukasstockner97) added a comment to T50724: Add note to blender Manual: Color picker RGB is not gamma corrected.

To be precise, the RGB numbers are in the Scene Linear colorspace, which with the default OCIO config is Linear sRGB aka Rec.709.

Wed, Feb 22, 3:26 PM · Documentation

Tue, Feb 21

Julien DUROURE (julien) added a project to T50724: Add note to blender Manual: Color picker RGB is not gamma corrected: Documentation.
Tue, Feb 21, 5:04 PM · Documentation
Aaron Carlisle (Blendify) abandoned D2516: Glossary cleanup + some color terms.
Tue, Feb 21, 2:05 AM · Documentation
Aaron Carlisle (Blendify) added a comment to D2516: Glossary cleanup + some color terms.

Committed with some edits

Tue, Feb 21, 2:04 AM · Documentation
Aaron Carlisle (Blendify) updated subscribers of D2522: Api docs: use new urls.
Tue, Feb 21, 12:02 AM · BF Blender, Infrastructure: Websites, Documentation
Aaron Carlisle (Blendify) created D2522: Api docs: use new urls.
Tue, Feb 21, 12:02 AM · BF Blender, Infrastructure: Websites, Documentation

Mon, Feb 20

Aaron Carlisle (Blendify) added a member for Documentation: blend-it (blend-it).
Mon, Feb 20, 9:34 PM
Aaron Carlisle (Blendify) edited Description on Documentation.
Mon, Feb 20, 4:45 PM
Aaron Carlisle (Blendify) added a member for Documentation: zdy (NGENNGT).
Mon, Feb 20, 4:44 PM

Sat, Feb 18

Aaron Carlisle (Blendify) added a reviewer for D2516: Glossary cleanup + some color terms: Troy Sobotka (sobotka).
Sat, Feb 18, 6:31 AM · Documentation

Fri, Feb 17

blend-it (blend-it) added a watcher for Documentation: blend-it (blend-it).
Fri, Feb 17, 7:14 PM
Aaron Carlisle (Blendify) edited the description of T50464: Move content from wiki to manual.
Fri, Feb 17, 2:23 AM · Documentation
Aaron Carlisle (Blendify) edited the description of T50464: Move content from wiki to manual.
Fri, Feb 17, 2:21 AM · Documentation

Wed, Feb 15

Alexandr (alvlapo) added a watcher for Documentation: Alexandr (alvlapo).
Wed, Feb 15, 3:10 PM

Sat, Feb 11

Aaron Carlisle (Blendify) abandoned D2503: Manual: Split glossary.
Sat, Feb 11, 7:26 PM · Documentation
Aaron Carlisle (Blendify) added a comment to D2503: Manual: Split glossary.

I decided to add more terms and clean up things before thinking about splitting

Sat, Feb 11, 7:25 PM · Documentation

Thu, Feb 9

Greg Zaal (gregzaal) removed a member for Documentation: Greg Zaal (gregzaal).
Thu, Feb 9, 10:01 AM

Wed, Feb 8

Tobias Heinke (TobiasH) added a comment to T50624: Split Glossary.

I think/agree that the one page glossary reached it's limit and can't handle additional terms.

Wed, Feb 8, 8:53 PM · Documentation
Aaron Carlisle (Blendify) claimed T50624: Split Glossary.
Wed, Feb 8, 6:40 PM · Documentation
Aaron Carlisle (Blendify) added a task to D2503: Manual: Split glossary: T50624: Split Glossary.
Wed, Feb 8, 6:40 PM · Documentation
Aaron Carlisle (Blendify) added a revision to T50624: Split Glossary: D2503: Manual: Split glossary.
Wed, Feb 8, 6:40 PM · Documentation
Aaron Carlisle (Blendify) updated the summary for D2503: Manual: Split glossary.
Wed, Feb 8, 6:40 PM · Documentation
Aaron Carlisle (Blendify) edited the description of T50624: Split Glossary.
Wed, Feb 8, 6:39 PM · Documentation
Aaron Carlisle (Blendify) changed Type from Bug to Design on T48096: New Wiki.
Wed, Feb 8, 6:30 PM · Documentation, Infrastructure: Websites
Aaron Carlisle (Blendify) changed Type from Bug to Design on T50466: Relocation of the documention (final solution).
Wed, Feb 8, 6:29 PM · Infrastructure: Websites, Documentation
Aaron Carlisle (Blendify) changed Type from Bug to Design on T50624: Split Glossary.
Wed, Feb 8, 6:28 PM · Documentation
Aaron Carlisle (Blendify) added a comment to T50624: Split Glossary.

Sure although I does not really change anything

Wed, Feb 8, 6:28 PM · Documentation
Ray Mairlot (madog) added a comment to T50624: Split Glossary.

I notice that this and a few other documentation tasks are of type 'Bug', but shouldn't they be 'Design' when they are about discussing changes?

Wed, Feb 8, 6:25 PM · Documentation
Aaron Carlisle (Blendify) created T50624: Split Glossary.
Wed, Feb 8, 4:53 PM · Documentation

Tue, Feb 7

Aaron Carlisle (Blendify) updated the diff for D2503: Manual: Split glossary.

Fix missing term

Tue, Feb 7, 5:55 PM · Documentation
Aaron Carlisle (Blendify) updated the summary for D2503: Manual: Split glossary.
Tue, Feb 7, 5:12 PM · Documentation
Aaron Carlisle (Blendify) updated the diff for D2503: Manual: Split glossary.

Make patch apply 2.

Tue, Feb 7, 5:11 PM · Documentation
Aaron Carlisle (Blendify) updated the diff for D2503: Manual: Split glossary.

Make patch apply.

Tue, Feb 7, 5:00 PM · Documentation
Aaron Carlisle (Blendify) retitled D2503: Manual: Split glossary, from "Split glossary" to "Manual: Split glossary".
Tue, Feb 7, 4:58 PM · Documentation
Aaron Carlisle (Blendify) closed T50355: Unsquared roughness of some shaders as "Resolved" by committing rBM3267: Fix T50355 Unsquared roughness of some shaders.
Tue, Feb 7, 2:08 AM · Documentation
Aaron Carlisle (Blendify) closed T50342: Spanish translation as "Archived".

Any word @marcal mora (blendercat)? I am archiving this task for now.

Tue, Feb 7, 1:18 AM · Documentation
Aaron Carlisle (Blendify) closed T50589: game engine render properties documentation as "Resolved".
Tue, Feb 7, 12:28 AM · Game Engine, Documentation
Aaron Carlisle (Blendify) edited Description on Documentation.
Tue, Feb 7, 12:26 AM

Sat, Feb 4

Aaron Carlisle (Blendify) edited the description of T50464: Move content from wiki to manual.
Sat, Feb 4, 7:46 PM · Documentation