From 537cb6cb500b31f63b75b97724c93c5c84df8442 Mon Sep 17 00:00:00 2001 From: Madalena Melo <144885032+madalenapmelo-kp@users.noreply.github.com> Date: Wed, 11 Dec 2024 13:42:17 +0100 Subject: [PATCH 1/2] File history versions https://tree.taiga.io/project/penpot/task/9377 --- docs/user-guide/workspace-basics/index.njk | 33 +++++++++++++++++----- 1 file changed, 26 insertions(+), 7 deletions(-) diff --git a/docs/user-guide/workspace-basics/index.njk b/docs/user-guide/workspace-basics/index.njk index 55e98657a..2e0bbceef 100644 --- a/docs/user-guide/workspace-basics/index.njk +++ b/docs/user-guide/workspace-basics/index.njk @@ -200,19 +200,38 @@ geometric structure. In Penpot there are three types of guides:

History

-

The history panel keeps track of the latest changes on an opened file.

+

The history panel keeps track of the latest changes on an opened file as well as the different versions of the file, making it easier to track changes, revert to previous states and collaborate.

View history

-

To view the recent history of a file at the workspace click at the history icon on the toolbar at the left.

-

At the history you can see items with information about the last changes. At first sight you have object type (rectangle, text, image...) and type of change (New, Modified, Deleted...). If you press the item further details are shown.

+

To view the recent history of a file at the workspace click the history icon on the navbar at the left:

+ + +
History
+

At the History panel, you can save the current version of your file, as well as access previous versions for up to 7 days.

+ +
Saved versions
+

You can save the current version of your file by clicking the pin icon at the History tab. This will allow the version to be named and it will add it to your list of versions.

+ +
Autosaved versions
+

When you start working on a file, Penpot will start to automatically save versions of that file across time so that you can later restore them as needed.

+

In the History tab, if you click on the autosaved versions, you’ll see a list of the exact date and time when the version was automatically saved. Each version of the file can be restored, reverting the file back to its state at the selected time.

+ +
Pinned versions
+

File versions can also be pinned. Pinning a file version will allow you to name it, making it easier to access at the History tab. Pinned file versions will be saved forever and can be renamed, restored or deleted at any time.

+ +
Actions
+

At the Actions panel, you have the object type (rectangle, text, image...) and type of change (New, Modified, Deleted...). If you press the item, it will be reverted to its state before that specific action was performed.

History panel
-

Note: History panel is still in a very early state and shows only a limited list of changes at a current browser tab session. Refreshing the browser means refreshing the History as well. Eventually, Penpot will have a proper version history capacity.

+

The Actions panel shows only a limited list of changes at a current browser tab session. Refreshing the browser means refreshing the history of actions as well.

-

Navigate history

-

To navigate through the history press Ctrl/⌘ + Z to go backwards and Ctrl/⌘ + Shift/⇧ + Z to go forward.

-

You can also press any item of the history list to get to this specific state.

+

Navigate actions

+

To navigate through the actions press Ctrl/⌘ + Z to go backwards and Ctrl/⌘ + Shift/⇧ + Z to go forward.

+

You can also press any item of the actions list to get to this specific state.

-

History

+

File history versions

The history panel keeps track of the latest changes on an opened file as well as the different versions of the file, making it easier to track changes, revert to previous states and collaborate.

-

View history

+

View history

To view the recent history of a file at the workspace click the history icon on the navbar at the left:

+
+ History versions button +
-
History
+

History panel

At the History panel, you can save the current version of your file, as well as access previous versions for up to 7 days.

-
Saved versions
+

Restore versions

+

All saved versions of the file—whether manually saved, autosaved, or pinned—can be restored, reverting the file back to its state at the selected time.

+
+ Restore versions +
+ +

Saved versions

You can save the current version of your file by clicking the pin icon at the History tab. This will allow the version to be named and it will add it to your list of versions.

+
+ Saved versions +
-
Autosaved versions
+

Autosaved versions

When you start working on a file, Penpot will start to automatically save versions of that file across time so that you can later restore them as needed.

-

In the History tab, if you click on the autosaved versions, you’ll see a list of the exact date and time when the version was automatically saved. Each version of the file can be restored, reverting the file back to its state at the selected time.

+

In the History tab, if you click on the autosaved versions, you’ll see a list of the exact date and time when the version was automatically saved.

+
+ Autosaved versions +
-
Pinned versions
+

Pinned versions

File versions can also be pinned. Pinning a file version will allow you to name it, making it easier to access at the History tab. Pinned file versions will be saved forever and can be renamed, restored or deleted at any time.

+
+ Pin versions +
-
Actions
+

Actions panel

At the Actions panel, you have the object type (rectangle, text, image...) and type of change (New, Modified, Deleted...). If you press the item, it will be reverted to its state before that specific action was performed.

- History panel + Actions panel

The Actions panel shows only a limited list of changes at a current browser tab session. Refreshing the browser means refreshing the history of actions as well.