DocumentationProject
ActivePublic

Properties

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)

If you are interested in becoming a contributor, 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

Yesterday

Tobias Heinke (TobiasH) added a comment to T49262: Manual Versioning.

There is also: sphinxcontrib-versioning , but it doesn't support internationalization (languages). It would do the first method "auto build" as described above. I can't tell if it works with SVN, then it maybe can be used for the API.

Wed, Mar 22, 2:47 PM · Infrastructure: Websites, Documentation

Tue, Mar 21

gines capote (gingraphic) added a watcher for Documentation: gines capote (gingraphic).
Tue, Mar 21, 9:36 PM

Sun, Mar 19

Aaron Carlisle (Blendify) added a member for Documentation: Takashi Sugawara (desigrammer).
Sun, Mar 19, 6:48 PM

Tue, Mar 14

Campbell Barton (campbellbarton) edited Description on Documentation.
Tue, Mar 14, 8:27 PM
Campbell Barton (campbellbarton) edited Description on Documentation.
Tue, Mar 14, 8:27 PM

Mon, Mar 13

blend-it (blend-it) edited the description of T42765: IT translation.
Mon, Mar 13, 9:41 AM · Documentation, Translations

Sun, Mar 12

Tobias Heinke (TobiasH) added a comment to T49262: Manual Versioning.

It's possible to have both: a numbered build and a release build (100% copy) on a new B. release the release tag gets a new clone.
Isn't that how it's handled in the api (current).

Sun, Mar 12, 8:14 PM · Infrastructure: Websites, Documentation
Aaron Carlisle (Blendify) added a comment to T43083: Translations (how to handle, design task).

I added you. Username and password are the same has what you used on this website.

Sun, Mar 12, 4:24 PM · Documentation
Aaron Carlisle (Blendify) added a member for Documentation: Alexandr (alvlapo).
Sun, Mar 12, 4:23 PM
Alexandr (alvlapo) added a comment to T43083: Translations (how to handle, design task).

I want to take part in the translation of documentation into Russian. But I can't commit changes documentation repo. Please add me to the documentation project.

Sun, Mar 12, 4:22 PM · Documentation

Sat, Mar 11

Germano Cavalcante (mano-wii) closed T50913: "Rotational difference" variable is missing for Objects as "Resolved".

solved by rB98045648ab4907a9843ede70de90ef923229dacc

Sat, Mar 11, 2:46 PM · Documentation, BF Blender
Germano Cavalcante (mano-wii) added a comment to T50913: "Rotational difference" variable is missing for Objects.

Feature requests are usually marked as TODOs.
But as this is a simpes addition (and will be in accordance with the manual), it was accepted ;)

Sat, Mar 11, 2:44 PM · Documentation, BF Blender
Campbell Barton (campbellbarton) added a member for Documentation: Germano Cavalcante (mano-wii).
Sat, Mar 11, 2:30 PM

Fri, Mar 10

Germano Cavalcante (mano-wii) added a comment to T50913: "Rotational difference" variable is missing for Objects.

I do not know why it does not support objects. (The code was made only for bones.)
Here a solution, I will talk to the core devs to see what they think.
P451

Fri, Mar 10, 9:46 PM · Documentation, BF Blender
Serge Lyatin (SergeL) created T50913: "Rotational difference" variable is missing for Objects.
Fri, Mar 10, 5:54 PM · Documentation, BF Blender
Bastien Montagne (mont29) closed T50907: API documentation link broken in some releases as "Archived".

yeah, need to generate 2.78c API doc… thanks for the report, not a bug in any case.

Fri, Mar 10, 3:28 PM · Python, Documentation
Michael Otto (mayqel) created T50907: API documentation link broken in some releases.
Fri, Mar 10, 9:30 AM · Python, Documentation

Tue, Mar 7

Francesco Siddi (fsiddi) added a comment to T49262: Manual Versioning.

I recommend a simpler approach:

Tue, Mar 7, 7:27 PM · Infrastructure: Websites, Documentation

Sun, Mar 5

Tobias Heinke (TobiasH) added a comment to T49262: Manual Versioning.
  1. Tagging

Currently the manual is tagged: 2.78, dev
https://svn.blender.org/svnroot/bf-manual/tags/

Sun, Mar 5, 8:58 PM · Infrastructure: Websites, Documentation

Sat, Mar 4

Julian Eisel (Severin) added a member for Documentation: Joey Ferwerda (TheOnlyJoey).
Sat, Mar 4, 4:15 PM

Thu, Mar 2

Aaron Carlisle (Blendify) added a comment to T49262: Manual Versioning.

I agree that we should do something like pydoc. I think we make version picker badge like rtd
which include two separate dropdown/up menus that also have search functionality (at least for language)
Here is a quick mockup:

Thu, Mar 2, 9:51 PM · Infrastructure: Websites, Documentation
Tobias Heinke (TobiasH) added a comment to T49262: Manual Versioning.

I investigated this a bit further:
there are two options:

Thu, Mar 2, 8:52 PM · Infrastructure: Websites, Documentation

Tue, Feb 28

Aaron Carlisle (Blendify) closed T50814: More, Less, and Ungrouped Vertices are TODO in docs as "Resolved".
Tue, Feb 28, 11:55 PM · Documentation
Aaron Carlisle (Blendify) closed T50815: Align Active Camera to Selected, View Lock to Active, and View Lock Clear Incomplete in Docs as "Resolved".
Tue, Feb 28, 11:55 PM · Documentation
John Roper (johnroper100) raised the priority of T47052: Physics Introduction needs a Rewrite from "Normal" to "Needs Triage".
Tue, Feb 28, 11:48 PM · Documentation
John Roper (johnroper100) added a revision to T47052: Physics Introduction needs a Rewrite: D2540: Fix for T47052: Physics Introduction needs a Rewrite.
Tue, Feb 28, 11:48 PM · Documentation
Aaron Carlisle (Blendify) closed D2536: Complete "Align Active Camera to Selected, View Lock to Active, and View Lock Clear" in Docs by committing rBM3413: Complete "Align Active Camera to Selected, View Lock to Active, and View Lock….
Tue, Feb 28, 11:33 PM · Documentation
Aaron Carlisle (Blendify) closed D2537: More, Less, Ungrouped Vertices, and Fill Region in Docs by committing rBM3411: More, Less, Ungrouped Vertices, and Fill Region in Docs.
Tue, Feb 28, 11:25 PM · Documentation
John Roper (johnroper100) claimed T47052: Physics Introduction needs a Rewrite.

I have started working on this.

Tue, Feb 28, 10:44 PM · Documentation
Ryan Birmingham (birm) added a comment to T50815: Align Active Camera to Selected, View Lock to Active, and View Lock Clear Incomplete in Docs.

Created D2536 for review.

Tue, Feb 28, 3:53 PM · Documentation
Ryan Birmingham (birm) added a comment to T50814: More, Less, and Ungrouped Vertices are TODO in docs.

Created D2537 for review.

Tue, Feb 28, 3:52 PM · Documentation
Ryan Birmingham (birm) retitled D2537: More, Less, Ungrouped Vertices, and Fill Region in Docs from to More, Less, Ungrouped Vertices, and Fill Region in Docs.
Tue, Feb 28, 3:52 PM · Documentation
Ryan Birmingham (birm) retitled D2536: Complete "Align Active Camera to Selected, View Lock to Active, and View Lock Clear" in Docs from to Complete "Align Active Camera to Selected, View Lock to Active, and View Lock Clear" in Docs.
Tue, Feb 28, 3:24 PM · Documentation
Ryan Birmingham (birm) changed Type from Bug to To Do on T50815: Align Active Camera to Selected, View Lock to Active, and View Lock Clear Incomplete in Docs.
Tue, Feb 28, 8:29 AM · Documentation
Ryan Birmingham (birm) created T50815: Align Active Camera to Selected, View Lock to Active, and View Lock Clear Incomplete in Docs.
Tue, Feb 28, 8:28 AM · Documentation
Ryan Birmingham (birm) created T50814: More, Less, and Ungrouped Vertices are TODO in docs.
Tue, Feb 28, 8:26 AM · Documentation

Mon, Feb 27

Ryan Birmingham (birm) closed T50791: 3d cursor "Usage" Header is todo as "Resolved".
Mon, Feb 27, 10:18 PM · Documentation
Ryan Birmingham (birm) closed T50792: Node Editor Docs Mute and Detach Unfinished as "Resolved".
Mon, Feb 27, 5:35 PM · Documentation
Ryan Birmingham (birm) added a watcher for Documentation: Ryan Birmingham (birm).
Mon, Feb 27, 4:32 PM
Ryan Birmingham (birm) added a comment to T50791: 3d cursor "Usage" Header is todo.

I've created D2532 for review for this addition to the documentation.

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

I've created D2533 for review for this addition to the documentation.

Mon, Feb 27, 3:18 PM · Documentation
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