Add doc on workspace persistence (#25062)

Joseph T. Lyons created

Release Notes:

- N/A

Change summary

docs/src/SUMMARY.md               |  1 +
docs/src/workspace-persistence.md | 14 ++++++++++++++
2 files changed, 15 insertions(+)

Detailed changes

docs/src/SUMMARY.md 🔗

@@ -7,6 +7,7 @@
 - [Linux](./linux.md)
 - [Windows](./windows.md)
 - [Telemetry](./telemetry.md)
+- [Workspace Persistence](./workspace-persistence.md)
 - [Additional Learning Materials](./additional-learning-materials.md)
 
 # Configuration

docs/src/workspace-persistence.md 🔗

@@ -0,0 +1,14 @@
+# Workspace Persistence
+
+Zed creates local SQLite databases to persist data relating to its workspace and your projects. These databases store, for instance, the tabs and panes you have open in a project, the scroll position of each open file, the list of all projects you've opened (for the recent projects modal picker), etc. You can find and explore these databases in the following locations:
+
+- macOS: `~/Library/Application Support/Zed/`
+- Linux: `~/.local/share/Zed`
+- Windows: `%LOCALAPPDATA%\Zed`
+
+The naming convention of these databases takes on the form of `0-<zed_channel>`:
+
+- Stable: `0-stable`
+- Preview: `0-preview`
+
+**If you encounter workspace persistence issues in Zed, deleting the database and restarting Zed often resolves the problem, as the database may have been corrupted at some point.**