Decisions and the charter#

Applies to v0.13Last reviewed

In short

A decision is something the production settled that should hold for every take, written down so people, the checks and CODA all work to it. The charter is the production's goal, audience and tone in a few sentences. This page explains how to write, propose, accept, amend and withdraw a decision.

Some things get settled once and should hold for every take: "everything is delivered at 2.39:1", "hero shots use only these models", "no take costs more than $2". A decision writes that down, with why, so the next person (and CODA) does not have to ask again. The charter is the shorter, softer record of what the production is for.

Both live in Files, under Decisions, below the nine foldersDecisions in FilesA map of the Zymcos workspace with the Files tab open. The Decisions row, marked 1, is in the System list on the left, below the folders and just above Cuts.1Decisions is a row in the System list, below the folders and just above Cuts. Your decisions and the charter are both under it.A map of the Zymcos workspace, drawn from its layout. Your screen has more on it.. They are documents, not files: there is nothing to download, and they cannot be moved into a folder.

The charter#

Five short fields: goal, audience, tone, deliverables and brand, two thousand characters in all. Choose Write the charter (or Edit) at the top of Decisions. CODA reads the charter before every reply, so what you write here shapes what it suggests. In a Solo production anyone who can curate may edit it; in Studio you need the approve right.

Writing a decision#

Choose New decision. A decision has:

  • a title;
  • four short sections: context (what led to this), decision (what was decided), alternatives considered and consequences;
  • optionally some rules the checks can read: an aspect ratio, a minimum resolution, models that are allowed or never allowed, or a most a take may cost.

Saving makes a draft. A draft has no number and can be edited or discarded freely. CODA can write a draft for you too: tell it what the production has agreed ("write that down as a production decision") and it drafts one for you to read. It never proposes or accepts for you.

Propose, accept, amend, withdraw#

StepWhat it doesWho
ProposeGives the draft its number (PDR-0001, PDR-0002…) and puts it up for acceptanceanyone who can curate
AcceptPuts the decision in force. Its text is then fixedsomeone who can approve
AmendProposes a change to a decision in force. The accepted text keeps ruling until the amendment is acceptedanyone who can curate; accepting needs approve
WithdrawTakes a decision out of force. It stays on recordsomeone who can approve

Accepted text is never edited, only amended or replaced, so the history on each decision is complete. Numbers are never reused.

What a decision does#

A decision in force with rules is read by the Production decisions check on every request to make a take a final (see Finals and requests). A take that breaks a rule fails that check, with the rule named. A decision with no rules is read by people and by CODA, which follows it over a passing preference or an older memory, and says so.

A decision can apply to the whole production, or, when drafted with CODA, to one scene, shot or Bible entry.

The history#

Each decision lists its steps in order, with the date, a mark on your own, and with CODA where CODA wrote the text. Steps are recorded against a private reference rather than a name, so if a person is later erased the history stays complete and unchanged.