[pbs-devel] applied: [PATCH proxmox-backup v3] docs: explain some technical details about datastores/chunks

Thomas Lamprecht t.lamprecht at proxmox.com
Thu Feb 4 12:34:51 CET 2021


On 11.12.20 13:17, Dominik Csapak wrote:
> adds explanations for:
> * what datastores are
> * their relation with snapshots/chunks
> * basic information about chunk directory structures
> * fixed-/dynamically-sized chunks
> * special handling of encrypted chunks
> * hash collision probability
> * limitation of file-based backups
> 
> Signed-off-by: Dominik Csapak <d.csapak at proxmox.com>
> ---
> changes from v2:
> * incoporate @F.Ebners and @D.Whytes suggestions, thanks :)
> 
>  docs/index.rst              |   1 +
>  docs/technical-overview.rst | 166 ++++++++++++++++++++++++++++++++++++
>  docs/terminology.rst        |   3 +
>  3 files changed, 170 insertions(+)
>  create mode 100644 docs/technical-overview.rst
> 
>

applied, thanks!

FYI, I made two followups:
* fixing up the line length (seemed a bit arbitrary, maybe let this get enforced by
  your editor for .rst/.adoc files)
* a few style nits to better comply with our technical writing guide, mostly
  dropping the usage of "we" (we who?). see our guide in the intranet (Avoid first
  person (plural)) for details. Threw in also some additions in that comment, was
  to much work to separate those two from each other..





More information about the pbs-devel mailing list