Revisions

In addition to the version history of objects, changes logically related to the editing of repositories are also recorded in FirstSpirit. This state of the whole system at a specific time is called a revision. Revisions are consecutively numbered:

• all new objects created in a revision have the same new revision number,
• changed objects are not overwritten in the repository, but instead are each added as a new object (with a higher revision number),
• all unchanged objects keep their old revision numbers.

Example:

Initial state: The current repository revision is 10.

User action: The user creates Object A (e.g. a new section on a page) and changes Object B (e.g. an existing section). Object C (e.g. another page) remains unchanged.

Result: If this action is transferred to the repository (e.g. by exiting the editing process on the page by means of “Save” or using the key shortcut Ctrl+E), a new repository revision is created with the number 11. Both Objects A and B are also assigned revision number 11. As Object A is a newly created object, it only exists in precisely one revision (11). As Object B was changed and the old state may not be overwritten, Object B now exists in several revisions (in this example, 5, 8 and 11). All unchanged objects retain their last revisions so that, for example, Object C retains Revision 8 (the last revision in which this object was changed).