2
0
Эх сурвалжийг харах

fixup! Add quickstart introduction to repositories & archives (fixes #3620)

Milkey Mouse 7 жил өмнө
parent
commit
d41c9296c0
1 өөрчлөгдсөн 9 нэмэгдсэн , 7 устгасан
  1. 9 7
      docs/quickstart.rst

+ 9 - 7
docs/quickstart.rst

@@ -16,13 +16,15 @@ A step by step example
 Archives and repositories
 -------------------------
 
-A Borg archive is used similarly to a tarball in a simpler backup system. When ``borg create``
-is run on a path, the current state of the files therein is stored in an archive. One can later
-extract or mount an archive to restore from a backup.
-
-Repositories are self-contained stores of archives that can be stored locally or remotely.
-Archives stored inside a repository are deduplicated with one another, which is why Borg
-shines for incremental backups.
+A *Borg archive* is the result of a single backup (``borg create``). An archive
+stores a snapshot of the data of the files "inside" it. One can later extract or
+mount an archive to restore from a backup.
+
+*Repositories* are filesystem directories acting as self-contained stores of archives.
+Repositories can be accessed locally via path or remotely via ssh. Under the hood,
+repositories contain data blocks and a manifest tracking which blocks are in each
+archive. If some data hasn't changed from one backup to another, Borg can simply
+reference an already uploaded data chunk (deduplication).
 
 Important note about free space
 -------------------------------