From 49019d4f4cf33a6c2b0c99adefe6860a8a3c1f94 Mon Sep 17 00:00:00 2001
From: Marcin Rataj <lidel@lidel.org>
Date: Thu, 14 Nov 2024 23:03:20 +0100
Subject: [PATCH] docs: size-related labels in Files screen (#2295)

* docs: clarify mfs total size caveat
* refactor: rename to localDatastoreDescription
reducing confusion + forcing fresh translation without historical ones

* refactor: rename to currentLocation
similar, make it more clear the value applies to currently displayed
directory

* docs: add preloadNote
* docs: clarify size value sources
---
 public/locales/en/files.json                         | 9 ++++++---
 src/files/header/Header.js                           | 4 ++--
 src/files/modals/add-by-path-modal/AddByPathModal.js | 4 ++++
 3 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/public/locales/en/files.json b/public/locales/en/files.json
index d49556511..0614e005d 100644
--- a/public/locales/en/files.json
+++ b/public/locales/en/files.json
@@ -54,6 +54,7 @@
   "addByPathModal": {
     "title": "Import from IPFS",
     "description": "Insert an IPFS path (CID) to import.",
+    "preloadNote": "NOTE: Imported path is lazy-loaded by default, and will be retrieved on-demand as you browse it. To proactively prefetch imported path to the local Datastore, choose ”Download” from the context menu.",
     "importPathPlaceholder": "Path or CID (required)",
     "namePlaceholder": "Name (optional)",
     "examples": "Examples:"
@@ -114,9 +115,11 @@
   "clickToDismiss": "Click to dismiss",
   "clickToCancel": "Click to cancel",
   "blocks": "Blocks",
-  "allBlocks": "All blocks",
-  "allBlocksDescription": "Total size of blocks on your entire IPFS node; this includes everything in Files, plus all locally pinned items and any temporary cached data",
-  "filesDescription": "Total size of data in the current directory (if a subdirectory, the size of all data in Files is also displayed)",
+  "localDatastore": "Local Datastore",
+  "localDatastoreDescription": "Total size of all blocks currently stored in the Datastore of your IPFS node (“RepoSize” from “ipfs repo stat”). This includes everything in the Files view (MFS), low-level pins, and any recently removed or temporary cached blocks that were not garbage-collected yet.",
+  "currentLocationRoot": "My Files",
+  "currentLocation": "Current Location",
+  "currentLocationDescription": "Total size of the DAG behind the current directory (“CumulativeSize” from “ipfs files stat”). This value includes both local and remote blocks, and could be bigger than the size of your local datastore.",
   "pinningQueue": "Pinning queue",
   "more": "More",
   "files": "Files",
diff --git a/src/files/header/Header.js b/src/files/header/Header.js
index 36298d287..ce9142109 100644
--- a/src/files/header/Header.js
+++ b/src/files/header/Header.js
@@ -72,7 +72,7 @@ class Header extends React.Component {
               className='fill-teal PendingAnimation' />
           </a> }
 
-          <BarOption title={t('filesDescription')} text={t('app:terms:files')}>
+          <BarOption title={t('currentLocationDescription')} text={hasUpperDirectory ? t('currentLocation') : t('currentLocationRoot')}>
             { hasUpperDirectory
               ? (
                 <span>
@@ -82,7 +82,7 @@ class Header extends React.Component {
               : size(filesSize) }
           </BarOption>
 
-          <BarOption title={t('allBlocksDescription')} text={t('allBlocks')}>
+          <BarOption title={t('localDatastoreDescription')} text={t('localDatastore')}>
             { size(repoSize) }
           </BarOption>
 
diff --git a/src/files/modals/add-by-path-modal/AddByPathModal.js b/src/files/modals/add-by-path-modal/AddByPathModal.js
index 251fada86..b5b1ca7f8 100644
--- a/src/files/modals/add-by-path-modal/AddByPathModal.js
+++ b/src/files/modals/add-by-path-modal/AddByPathModal.js
@@ -106,6 +106,10 @@ class AddByPathModal extends React.Component {
             name='name'
             className='input-reset charcoal ba b--black-20 br1 pa2 mb2 db w-90 center focus-outline'
             type='text' />
+
+          <div className='mt3 mb3 flex flex-column items-center'>
+            <p className='mt0 charcoal tl w-90'>{t('addByPathModal.preloadNote')}</p>
+          </div>
         </ModalBody>
 
         <ModalActions>