From 26d7d19a9804ebc73bc9a65abd12906819267d08 Mon Sep 17 00:00:00 2001
From: shamoon <4887959+shamoon@users.noreply.github.com>
Date: Wed, 1 May 2024 13:46:30 -0700
Subject: [PATCH] Updated docs, display text

---
 docs/usage.md                                              | 7 +++++++
 src-ui/src/app/components/admin/trash/trash.component.html | 4 +++-
 src-ui/src/app/components/admin/trash/trash.component.ts   | 2 +-
 3 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/docs/usage.md b/docs/usage.md
index 5705be3da..14d78bed7 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -478,6 +478,13 @@ As of version 2.7, Paperless-ngx automatically records all changes to a document
 Changes to documents are visible under the "History" tab. Note that certain changes such as those made by workflows, record the 'actor'
 as "System".
 
+## Document Trash
+
+When you first delete a document it is moved to the 'trash' until either it is explicitly deleted or it is automatically removed after a set amount of time has passed.
+You can set how long documents remain in the trash before being automatically deleted with [`EMPTY_TRASH_DELAY`](configuration.md#EMPTY_TRASH_DELAY), which defaults
+to 30 days. Additionally you may configure a directory where deleted documents are moved to when they are finally deleted with [`PAPERLESS_TRASH_DIR`](configuration.md#PAPERLESS_TRASH_DIR).
+Note that the trash directory only stores the original file, the archive version and all database information is permanently removed once a document is fully deleted.
+
 ## Best practices {#basic-searching}
 
 Paperless offers a couple tools that help you organize your document
diff --git a/src-ui/src/app/components/admin/trash/trash.component.html b/src-ui/src/app/components/admin/trash/trash.component.html
index 08de0abd6..99ac929a9 100644
--- a/src-ui/src/app/components/admin/trash/trash.component.html
+++ b/src-ui/src/app/components/admin/trash/trash.component.html
@@ -1,7 +1,9 @@
 <pngx-page-header
 title="Trash"
 i18n-title
-info="Manage trashed items."
+info="Manage trashed documents that are pending deletion."
+i18n-info
+infoLink="usage/#document-trash"
 >
 <button class="btn btn-sm btn-outline-secondary" (click)="clearSelection()" [hidden]="selectedDocuments.size === 0">
   <i-bs  name="x"></i-bs>&nbsp;<ng-container i18n>Clear selection</ng-container>
diff --git a/src-ui/src/app/components/admin/trash/trash.component.ts b/src-ui/src/app/components/admin/trash/trash.component.ts
index 5a68dc1c5..1f2dd69b4 100644
--- a/src-ui/src/app/components/admin/trash/trash.component.ts
+++ b/src-ui/src/app/components/admin/trash/trash.component.ts
@@ -73,7 +73,7 @@ export class TrashComponent implements OnDestroy {
     modal.componentInstance.title = $localize`Confirm delete`
     modal.componentInstance.messageBold = $localize`This operation will permanently delete ${
       documents?.size ?? $localize`all`
-    } documents.`
+    } documents in the trash.`
     modal.componentInstance.message = $localize`This operation cannot be undone.`
     modal.componentInstance.btnClass = 'btn-danger'
     modal.componentInstance.btnCaption = $localize`Delete`