Skip to content

EffectCraft: An open-source motion graphics and compositing tool written by scratch in pure Rust

docs: move #1104's project import notes from a stray parity-log.md into footage.md

Brandon Thomasc5bb5f439764
diff --git a/docs/footage.md b/docs/footage.md
index e626eee0d..9cfa022aa 100644
--- a/docs/footage.md
+++ b/docs/footage.md
@@ -58,6 +58,18 @@ sequences, except dropped files (`"drag": true`), which import as stills as in A
imports stills and a folder's files one by one, and `"alphabetical": true` is Force Alphabetical
Order.
+## Importing another project
+
+File ▸ Import ▸ EffectCraft Project… (or an `.ecproj` / `.ecprojx` file given to File ▸ Import)
+merges that project into the open one, inside a folder named after the file, as After Effects
+imports an `.aep`. Every item, layer and property id moves past the open project's, so precomps,
+parents, track mattes, Layer Control values, Essential Graphics and tracker targets keep pointing
+at the right things. It is one undo step. Footage paths relative to the imported project resolve
+next to it.
+
+Agents: `file.importProject {"path": "/projects/titles.ecproj"}` returns the comps, the root comps,
+`primaryComp` (the only root comp, if there is one) and any missing media.
+
## Interpret Footage
Select a footage item in the Project panel and choose **File ▸ Interpret Footage ▸ Main…**
diff --git a/docs/parity-log.md b/docs/parity-log.md
deleted file mode 100644
index 22319e6ee..000000000
--- a/docs/parity-log.md
+++ /dev/null
@@ -1,13 +0,0 @@
-
-## Update: File ▸ Import ▸ EffectCraft Project
-
-- **Import a project into a project**, as After Effects imports an `.aep`:
- `file.importProject {path}` (File ▸ Import ▸ EffectCraft Project..., and `.ecproj` /
- `.ecprojx` files given to File ▸ Import) merges the project into a folder named after the
- file. Every item, layer and property id moves past the open project's, so references
- (precomps, parents, track mattes, Layer Control values, Essential Graphics, tracker
- targets) stay intact. It's one undo step. Footage paths relative to the imported project
- resolve next to it. The result lists the comps, the root comps, `primaryComp` (the only
- root comp) and missing media.
-- Id shifting saturates instead of overflowing on damaged files, for both templates and
- projects.