blender-studio-pipeline/docs/pipeline-overview/introduction.md

Introduction

The goal of this documentation is to describe the pipeline and IT setup used at Blender Studio, in a way that can be replicated in another environment from scratch.

How to read/write the docs

The documentation features two types of content:

• Design docs: explanations and insight on why things are built in a certain way
• Guides, for two audiences:
  • users/artists learning how to perform certain workflows
  • TDs learning how to deploy and maintain the pipeline in a production environment

Design Docs

• Design principles (use Blender as much as possible, use add-ons only when needed, rely on Blender's linking system)
• Infrastructure
• Breakdown per department/workflow
  • Editorial and Previz
  • Concept design
  • Asset creation
    • Modeling
    • Shading and Texturing
    • Rigging
  • Shot assembly
  • Animation
  • Shading and lighting
  • Rendering
  • Task review
  • Coloring

These topics can be described at a high-level, and reference specific tools, add-ons and worfklows in a dedicated section.

Guides

Guides are detailed series of instructions that start from the topics described in the Design Docs and deal with them in a practical way. For example:

• Workstation reference
• Workflows (like Design Docs above, but the practical steps). Depending on the type of production, workflows often need to be changed and tweaked. That part can better be documented on the Blender Studio blog.
• Media Viewer reference
• Infrastructure setup (how to build a studio IT from scratch)

For "external" tools like Flamenco or Kitsu, the idea is to explain the specific use or customization we do a Blender Studio and refer to the official documentation for the rest. For example: "Install Kitsu by following the official guide".