[CHILI-GraFx] Storage (#244)

docs/CHILI-GraFx/concepts/sandbox/index.md

@@ -2,7 +2,7 @@
 
 ## Sandbox
 
-A sandbox deployment is like a test version of the CHILI GraFx platform or applications that allows you to experiment with new features without affecting the live production data. With each new release, the sandbox deployment will have the latest version of the platform and/or applications, but with separate data.
+A sandbox environment is like a test version of the CHILI GraFx platform or applications that allows you to experiment with new features without affecting the live production data. With each new release, the sandbox environments will have the latest version of the platform and/or applications, but with separate data.
 
 This means that any changes made in the sandbox will not affect the production data. The sandbox allows you to test new features to make sure they work properly before they are used in the live version.
 
@@ -12,15 +12,15 @@ Production is the live version of CHILI GraFx that customers use to access and u
 
 ## Why two versions?
 
-The reason for having a separate sandbox deployment is to allow developers, testers, and customers to test new features without affecting the live production data. This is important because it ensures that any issues or bugs are identified and fixed before they affect the people who are using the live version.
+The reason for having a separate sandbox is to allow developers, testers, and customers to test new features without affecting the live production data. This is important because it ensures that any issues or bugs are identified and fixed before they affect the people who are using the live version.
 
 ## UI and API
 
 Both the platform and application UI (the way the platform looks) and API (the way the platform works behind the scenes) are subject to the split between sandbox and production. Whenever there are new features added to the platform or applications, they are first deployed in the sandbox before being used in production.
 
 ## Testing
 
-We encourage you to setup a strategy to include testing the sandbox deployment as part of your product or platform lifecycle. This will ensure a more stable result.
+We encourage you to setup a strategy to include testing the sandbox as part of your product or platform lifecycle. This will ensure a more stable result.
 
 ## Sandbox on multi tenant vs private tenant
 

docs/CHILI-GraFx/concepts/storage/index.md

@@ -0,0 +1,29 @@
+# Understanding Storage Calculation
+
+This document outlines how your media assets, such as pictures, consume storage space in CHILI GraFx.
+
+## 1. **Uploading Media Assets**
+
+When you upload an asset, it occupies a certain amount of storage space. This space is primarily determined by the file size of the asset. For example, a 1 MB picture will initially take up 1 MB of storage space in your account.
+
+## 2. **The Role of Preview Files**
+
+For optimal performance, our application automatically creates preview files when you upload a media asset. These files are essential for the application to function correctly and efficiently over the web. They allow faster loading times and smoother access to your media, but they also require additional storage space. The size of these files varies depending on the original file but is a necessary part of the storage calculation.
+
+## 3. **Backup Storage**
+
+Data security is paramount for us ([ISO 27001](https://www.chili-publish.com/trust/)). Therefore, CHILI GraFx creates backups of your uploaded media assets, fonts and Smart Templates. These backups are essential to protect your data against accidental loss or corruption. However, like preview files, backups also take up additional storage space. We ensure that your data is safe and readily available whenever you need it, but this safety feature increases the total storage requirement.
+
+## 4. **Total Storage Calculation**
+
+The total storage space you see on your dashboard is not just the sum of the file sizes of your uploaded media. It is, in fact, a multiple of this size. This total includes:
+
+- The original media asset size (e.g., your pictures)
+- The font assets
+- The Smart Templates
+- The storage required for preview files
+- The storage required for backups
+
+## Conclusion
+
+Understanding how storage is calculated helps you manage your account effectively. It's important to remember that the total storage usage includes not just your uploaded files but also the additional space required for preview files, fonts, templates and backups, ensuring both performance and data safety.

mkdocs.yml

@@ -126,6 +126,7 @@ nav:
         - 'Concepts':
             - 'Template Management':            'CHILI-GraFx/concepts/template-management/index.md'
             - 'Renders':                        'CHILI-GraFx/concepts/renders/index.md'
+            - 'Storage':                        'CHILI-GraFx/concepts/storage/index.md'
             - 'Sandbox':                        'CHILI-GraFx/concepts/sandbox/index.md'
             - 'Subscriptions' :                 'CHILI-GraFx/concepts/subscriptions/index.md'
             - 'Federated Single Sign On':       'CHILI-GraFx/concepts/federated-single-sign-on/index.md'