Version History: Difference between revisions

From ACT3ai MediaWiki
Jump to navigation Jump to search
(Created page with "= Version History = == Overview == The Version History system in ACT 3 AI enables creators to track, branch, and manage changes across their projects. It supports non-destructive editing, collaborative iteration, and rollback functionality—ensuring that every creative decision is preserved and recoverable. == 1. Purpose == * Track changes at the script, scene, shot, and asset level * Allow safe experimentation through branching and merging * Enable collaborative revi...")
 
No edit summary
Line 2: Line 2:


== Overview ==
== Overview ==
The Version History system in ACT 3 AI enables creators to track, branch, and manage changes across their projects. It supports non-destructive editing, collaborative iteration, and rollback functionality—ensuring that every creative decision is preserved and recoverable.
The '''[[Version_History|Version History]]''' feature in [[ACT3AI|ACT 3 AI]] provides a detailed record of all changes made to [[Projects|projects]], [[Scripts|scripts]], [[Scenes|scenes]], and [[Build_Video|video assemblies]].
It tracks edits, saves, and renders over time, allowing creators and teams to review, compare, and restore earlier iterations.


== 1. Purpose ==
== Key Features ==
* Track changes at the script, scene, shot, and asset level
* **Change Log:** Full timeline of edits with timestamps and contributor names. 
* Allow safe experimentation through branching and merging
* **Snapshots:** Auto-saved points created during [[Script_Editing|script editing]], [[Timeline_View|timeline adjustments]], and [[Build_Video|video editing]]. 
* Enable collaborative review with comment threads per version
* **Manual Checkpoints:** Users can mark important milestones (e.g., “Draft v1,” “Final Cut”). 
* Provide visual diff and rollback tools for creative control
* **Comparison Tools:** Highlight differences between two versions of a script, timeline, or storyboard. 
* **Rollback & Restore:** Recover older versions without losing new ones. 


== 2. Versioning Scope ==
== Where Version History Applies ==
* Projects
* **Scripts:** Scene revisions, AI-generated rewrites, and dialogue changes. 
* Scripts and Dialogue
* **Timeline:** Adjustments in pacing, sequencing, and transitions. 
* Story Beats and Scene Structure
* **Storyboards:** Visual changes in [[Storyboard_Panels|Storyboard Panels]]. 
* Camera and Cinematography Settings
* **Digital Assets:** [[Set_Design|Sets]], [[Digital_Actors|Digital Actors]], and [[Style_Presets|style presets]]. 
* Character Design and Performance
* **Final Renders:** Records of outputs in [[Render_Queue|Render Queue]] and [[Export_Distribution|exports]]. 
* Visual Assets (Sets, Lighting, Costumes)
* Render Output Metadata


== 3. Key Features ==
== How to Access ==
* '''Auto-Save Checkpoints:''' Save state after major edits or renders
# Open your [[Editor|Editor Workspace]] or [[Projects|Project Dashboard]]. 
* '''Manual Snapshots:''' User-created named versions
# Click **File → Version History**. 
* '''Branch & Merge:''' Explore alternate storylines, then re-integrate
# Browse the chronological list of changes. 
* '''Compare View:''' Side-by-side visual or script diff
# Select one or more versions to preview. 
* '''Lock Versions:''' Prevent changes to approved content
# Choose to duplicate, rollback, or lock. 
* '''Restore Point:''' Roll back to any previous version


== 4. Collaboration Support ==
== Collaboration Integration ==
* Comment threads tied to specific versions
* Works with [[Organization_Management|Organization Management]] to track changes by user. 
* Reviewer tags and approvals
* Shows edits made by [[Editors|editors]], [[Reviewers|reviewers]], and [[Admins|admins]]. 
* Version summaries for tracking what changed and why
* Approved versions can be locked to prevent further changes. 
* Reviewers can comment on specific versions without altering them. 


== 5. Naming & Metadata ==
== Best Practices ==
Each version includes:
* Use manual checkpoints for critical milestones. 
* Timestamp
* Name versions clearly (e.g., “Client Feedback v2”). 
* Creator/editor name
* Regularly review history to avoid unnecessary [[Credit_System|credit consumption]]. 
* Description of changes
* Lock final versions for compliance and delivery. 
* Affected scenes, characters, or assets


== 6. Visual Diff Tools ==
== Troubleshooting ==
* Shot comparison: keyframe-to-keyframe visual delta
* **History not updating** → Ensure auto-save is enabled. 
* Dialogue diff: colored text changes with markup
* **Too many versions** → Archive older versions or branch projects. 
* Lighting or camera path animation previews
* **Rollback failed** → Re-open the [[Editor|Editor Workspace]] and reapply. 
* **Missing contributor data** → Check [[Organization_Management|team roles and permissions]]. 


== 7. Access & Permissions ==
== Example Workflow ==
* Editors and Owners can create branches and merge
1. Script created via [[AI_Wizard|AI Wizard]]. 
* Viewers can browse history but not modify
2. Revised in [[Script_Editing|Script Editor]]. 
* Roles can restrict overwrite or deletion of locked versions
3. Saved as **v1.0 – First Draft**. 
4. Storyboards added in [[Storyboard_Panels|Storyboard Panels]]. 
5. Final locked as **v2.0 – Approved** before sending to [[Render_Queue|Render Queue]]. 


== 8. Storage Impact ==
== See Also ==
* Versioned assets consume cloud storage quota
* [[Version_Control|Version Control]] 
* System prompts to archive or delete older versions if quota is exceeded
* [[Projects|Projects]] 
* Archived versions remain accessible in read-only mode
* [[Script_Editing|Script Editing]] 
* [[Timeline_View|Timeline View]] 
* [[Storyboard_Panels|Storyboards & Panels]] 
* [[Build_Video|Build Video]] 
* [[Organization_Management|Organization Management]] 


== 9. Export Options ==
[[Category:ACT 3 AI Features]] 
* Export specific versions as:
[[Category:Collaboration]] 
  * Final Draft (for scripts)
  * FBX/GLB (for scenes or characters)
  * MP4/MOV (for video renders)
  * YAML/JSON (for metadata snapshots)


== 10. Roadmap ==
[https://act3ai.com/contact Contact Us] if you have questions about version history or restoring earlier drafts.
* Timeline-based visual version history
* AI-suggested reverts based on performance analytics
* Version tagging for milestones (e.g., "Festival Cut", "Client Review")
* Multi-user conflict resolution with live merge previews

Revision as of 09:42, 27 August 2025

Version History

Overview

The Version History feature in ACT 3 AI provides a detailed record of all changes made to projects, scripts, scenes, and video assemblies. It tracks edits, saves, and renders over time, allowing creators and teams to review, compare, and restore earlier iterations.

Key Features

  • **Change Log:** Full timeline of edits with timestamps and contributor names.
  • **Snapshots:** Auto-saved points created during script editing, timeline adjustments, and video editing.
  • **Manual Checkpoints:** Users can mark important milestones (e.g., “Draft v1,” “Final Cut”).
  • **Comparison Tools:** Highlight differences between two versions of a script, timeline, or storyboard.
  • **Rollback & Restore:** Recover older versions without losing new ones.

Where Version History Applies

How to Access

  1. Open your Editor Workspace or Project Dashboard.
  2. Click **File → Version History**.
  3. Browse the chronological list of changes.
  4. Select one or more versions to preview.
  5. Choose to duplicate, rollback, or lock.

Collaboration Integration

  • Works with Organization Management to track changes by user.
  • Shows edits made by editors, reviewers, and admins.
  • Approved versions can be locked to prevent further changes.
  • Reviewers can comment on specific versions without altering them.

Best Practices

  • Use manual checkpoints for critical milestones.
  • Name versions clearly (e.g., “Client Feedback v2”).
  • Regularly review history to avoid unnecessary credit consumption.
  • Lock final versions for compliance and delivery.

Troubleshooting

  • **History not updating** → Ensure auto-save is enabled.
  • **Too many versions** → Archive older versions or branch projects.
  • **Rollback failed** → Re-open the Editor Workspace and reapply.
  • **Missing contributor data** → Check team roles and permissions.

Example Workflow

1. Script created via AI Wizard. 2. Revised in Script Editor. 3. Saved as **v1.0 – First Draft**. 4. Storyboards added in Storyboard Panels. 5. Final locked as **v2.0 – Approved** before sending to Render Queue.

See Also

Contact Us if you have questions about version history or restoring earlier drafts.

Retrieved from "https://wiki.act3ai.com/index.php?title=Version_History&oldid=647"