# HG changeset patch
# User Sebastien Jodogne <s.jodogne@gmail.com>
# Date 1614330201 -3600
# Node ID debcf6b6d0709f7f1c2b4564e5782edcfadcecaf
# Parent  05a5a7369126fd942647b654412383b8a4b6e36a
dicom-as-json is now deprecated

diff -r 05a5a7369126 -r debcf6b6d070 Sphinx/source/faq/features.rst
--- a/Sphinx/source/faq/features.rst	Fri Feb 26 09:00:27 2021 +0100
+++ b/Sphinx/source/faq/features.rst	Fri Feb 26 10:03:21 2021 +0100
@@ -234,11 +234,21 @@
 ``OrthancPluginSetGlobalProperty()``) are therefore kindly invited to
 complete the **central registry** below:
 
-* ``Attachment 1`` is used by the core of Orthanc to store DICOM instances
-* ``Attachment 2`` was used by Orthanc <= 1.9.0 to cache the :ref:`DICOM-as-JSON information <orthanc-storage>`
-* ``Attachment 3`` is used since Orthanc 1.9.1 to store the DICOM instance, until the ``Pixel Data (7fe0,0010)`` tag,
-  if global configuration option ``StorageCompression`` is ``true``, or if the storage area plugin doesn't support
-  range reads
+* ``Attachment 1`` is used by the core of Orthanc to store the DICOM
+  file associated with one instance.
+* ``Attachment 2`` was used by Orthanc <= 1.9.0 to cache the so-called
+  ``DICOM-as-JSON`` information (as returned by the
+  ``/instances/.../tags`` URI in the :ref:`REST API <rest>`) in order
+  to speed up subsequent requests to the same URI. This attachment is
+  not automatically generated anymore starting with Orthanc 1.9.1, in
+  order to improve performance (creating two files for each DICOM
+  instance has a cost) and consistency (if the DICOM dictionary gets
+  modified in the future).
+* ``Attachment 3`` is used since Orthanc 1.9.1 to store the DICOM
+  instance until the ``Pixel Data (7fe0,0010)`` tag, if the global
+  configuration option ``StorageCompression`` is ``true``, or if the
+  storage area plugin doesn't support range reads. This allows to
+  avoid downloading the full DICOM instance if not necessary.
 * ``Attachment 9997`` is used by the :ref:`Osimis WebViewer plugin <osimis_webviewer>` to store series information.
 * ``Attachment 9998`` is used by the :ref:`Osimis WebViewer plugin <osimis_webviewer>` to store instance information.
 * ``Attachment 9999`` is used by the :ref:`Osimis WebViewer plugin <osimis_webviewer>` to store annotations.
diff -r 05a5a7369126 -r debcf6b6d070 Sphinx/source/faq/orthanc-storage.rst
--- a/Sphinx/source/faq/orthanc-storage.rst	Fri Feb 26 09:00:27 2021 +0100
+++ b/Sphinx/source/faq/orthanc-storage.rst	Fri Feb 26 10:03:21 2021 +0100
@@ -9,13 +9,9 @@
 **By default** (i.e. if no database plugin such as :ref:`PostgreSQL
 <postgresql>` or :ref:`MySQL <mysql>` is used), Orthanc stores all the
 DICOM files it receives in a folder called ``OrthancStorage`` on the
-filesystem. Orthanc also associates each incoming DICOM file with a
-JSON file that summarizes all its DICOM tags, which speeds up
-subsequent processing by avoiding a costly DICOM parsing (these
-summaries are refered to as ``DICOM-as-JSON`` :ref:`attachments
-<metadata>`).
+filesystem.
 
-More generally, the ``OrthancStorage`` folder contains a set of
+More precisely, the ``OrthancStorage`` folder contains a set of
 so-called **attachments**, that may correspond to either a DICOM file,
 a JSON file, or any user-defined file. Internally, each attachment is
 automatically associated with an `universally unique identifier (UUID)