Exceptions-for-Error-Reporting.md

-<ol><li><strong>Debug mode:</strong> Exceptions thrown by the code (no by STL functions) must be inside a debug mode condition set in the ADIOS class constructor. Applications are encourages to turn these on when integrating with ADIOS2.</li><li><strong>Standard exception:</strong> Throw C++ standard exceptions for error handling, do not throw integers. This is helpful as it allows handling of different exception types in different ways. In rare cases a custom exceptions must be defined/declared.<ul><li><code>Don't</code><ul><li><pre style="border: 0;"><code> throw   1;</code></pre></li></ul></li><li><code>Do</code><ul><li><pre style="border: 0;"><code> throw   std::invalid_argument ( &quot;ERROR: group was not previously declared, in call to Write&quot; );</code></pre></li></ul></li></ul></li><li><strong>Document exceptions:</strong> All error exceptions must start with &quot;ERROR: &quot;.  Use informative and precise messages for exception handling to complement the nature of the exception to help the user identify and fix the issue.<ul><li><code>Don't</code><ul><li><pre style="border: 0;"><code> throw    std::invalid_argument  (   &quot;ERROR: invalid input for CompressionParameter&quot;  );</code></pre></li></ul></li><li><code>Do</code><ul><li><pre style="border: 0;"><code> throw    std::invalid_argument  (   &quot;ERROR: bzip2 CompressionParameter must be an unsigned int between 0 and 9, in call to Compress&quot;&quot;  );</code></pre></li></ul></li></ul></li></ol>
\ No newline at end of file
+<ol><li><strong>Debug mode:</strong> Exceptions thrown by the code (no by STL functions) must be inside a debug mode condition set in the ADIOS class constructor. Applications are encourages to turn these on when integrating with ADIOS2.</li><li><strong>Standard exception:</strong> Throw C++ standard exceptions for error handling, do not throw integers. This is helpful as it allows handling of different exception types in different ways. In rare cases a custom exceptions must be defined/declared.<ul><li><code>Don't</code><ul><li><pre style="border: 0;"><code> throw   1;</code></pre></li></ul></li><li><code>Do</code><ul><li><pre style="border: 0;"><code> throw   std::invalid_argument ( &quot;ERROR: group was not   
+                        previously declared, in call to Write&quot; );</code></pre></li></ul></li></ul></li><li><strong>Document exceptions:</strong> All error exceptions must start with &quot;ERROR: &quot;.  Use informative and precise messages for exception handling to complement the nature of the exception to help the user identify and fix the issue.<ul><li><code>Don't</code><ul><li><pre style="border: 0;"><code> throw    std::invalid_argument  (   &quot;ERROR: invalid input for CompressionParameter&quot;  );</code></pre></li></ul></li><li><code>Do</code><ul><li><pre style="border: 0;"><code> throw    std::invalid_argument  (   &quot;ERROR: bzip2 CompressionParameter must be an unsigned int between 0 and 9, in call to Compress&quot;&quot;  );</code></pre></li></ul></li></ul></li></ol>
\ No newline at end of file