Update Data Recovery section (new screenshots, preferences, etc.)

Author: dacap

data-recovery.md

@@ -1,15 +1,59 @@
 # Data Recovery
 
 When Aseprite is running, it saves some temporary data to restore your
-sprite in case that your computer (or Aseprite itself) crashes.
-This temporary data is saved in a subfolder named `sessions` inside your
+sprite in case that your computer (or Aseprite) crashes, or you close
+Aseprite without saving your sprites. (Even if you save your sprites,
+the original backup is kept in your disk at least for a couple of
+weeks.)
+
+## Open Sprites from Previous Sessions
+
+To restore a sprite from a previous sessions you have to use the
+"Recover Files" option in the "Home" tab:
+
+<p><img src="/docs/data-recovery/home-tab.png" alt="Home tab" class="x2" /></p>
+
+If Aseprite crashes (wasn't closed correctly) and some sprite wasn't
+saved, you will see the "Recover Files" option as a button:
+
+<p><img src="/docs/data-recovery/home-tab-after-crash.png" alt="Home tab" class="x2" /></p>
+
+This option opens the "Recover Files" tab, where you can double-click
+an item (or select it and press "Recover Sprite") to recover a sprite
+from a previous sessions:
+
+<p><img src="/docs/data-recovery/recover-files-tab.png" alt="Home tab" class="x2" /></p>
+
+## Preferences
+
+In the *Edit > Preferences > Files* section you can configure how the
+backup data is saved and for how long:
+
+![Data Recovery Preferences](data-recovery/recover-data-preferences.png)
+
+* *Automatically save recovery data every X seconds/minutes*:
+  Indicates that Aseprite should auto-save backup data (on disk) every
+  X seconds or minutes for each edited sprite (2 minutes by default).
+* *Keep edited sprite data for Y days/weeks/months*: For each sprite
+  that was edited, Aseprite will keep the backup data (on disk) for
+  the given number of days/weeks/months (1 week by default).
+* *Keep closed sprite on memory for Z seconds/minutes/hours*: If you
+  close a sprite by mistake, Aseprite will keep the sprite (on memory,
+  with the undo information) for at least the given time (15 minutes
+  by default). You can re-open a closed file
+  with *File > Open Recent > Reopen Closed File* menu
+  option (Ctrl+Shift+T or ⇧⌘T keyboard shortcut).
+
+## Internals
+
+The backup data is saved in a subfolder named `sessions` inside your
 [Preferences Folder](preferences-folder.md):
 
-> ![Sessions Folder](data-recovery/sessions-folder-focused.png)
+![Sessions Folder](data-recovery/sessions-folder-focused.png)
 
-In `sessions` might be several subfolders:
+`sessions` might contain several subfolders (one for each execution of Aseprite):
 
-> ![Inside Sessions Folder](data-recovery/in-sessions-folder.png)
+![Inside Sessions Folder](data-recovery/in-sessions-folder.png)
 
 The name of these folders (e.g. `20180405-165510-1128`) has a meaning,
 which is `YYYYMMDD-HHMMSS-PID`:
@@ -21,16 +65,13 @@ which is `YYYYMMDD-HHMMSS-PID`:
   handling that session folder.
 
 Each of these folders contain useful data to restore some sprites that
-you might have lost in the crash. When you start Aseprite again, you
-may see this button to recover those sprites:
-
-> ![Recover Lost Sprites Button](data-recovery/recover-lost-sprites-button.png)
+you might have lost in the crash.
 
-If you don't see the *"Recover Lost Sprites"* button when you launch
-Aseprite, but you have one of these `sessions/YYYYMMDD-HHMMSS-PID`
-folder in your [Preferences Folder](preferences-folder.md), you can
-compress one of those folder in a `.zip` and send it to
-[[email protected]](mailto:[email protected]). We can
+If you aren't able to recover your sessions using the "Recover Files"
+option from "Home" tab, but you have one of these
+`sessions/YYYYMMDD-HHMMSS-PID` folder in your [Preferences Folder](preferences-folder.md),
+you can compress one of those folder in a `.zip` and send it to
+[[email protected]](mailto:[email protected]). And we can
 try to recover your data.
 
 ---