docs: update API docs, CHANGELOG.md for v23.13.2 [skip ci]

CHANGELOG.md

@@ -1,6 +1,15 @@
 Changelog
 =========
 
+## [v23.13.2] - 2024-05-04
+### :bug: Bug Fixes
+- [`fc979a0`](https://github.com/tobymao/sqlglot/commit/fc979a0055c0f402cda77448d9c7dfecf45a901f) - **snowflake**: make FILE_FORMAT option always be uppercase in COPY INTO *(commit by [@georgesittas](https://github.com/georgesittas))*
+
+### :wrench: Chores
+- [`1b5b77d`](https://github.com/tobymao/sqlglot/commit/1b5b77d849260589a2f7d3593c4472e47cae0280) - improve unsupported error documentation *(PR [#3406](https://github.com/tobymao/sqlglot/pull/3406) by [@georgesittas](https://github.com/georgesittas))*
+- [`fcb51af`](https://github.com/tobymao/sqlglot/commit/fcb51afc4631cfc5f494c9114d4aba667aa46087) - release sqlglotrs only when Cargo.toml is updated *(PR [#3408](https://github.com/tobymao/sqlglot/pull/3408) by [@georgesittas](https://github.com/georgesittas))*
+
+
 ## [v23.13.1] - 2024-05-04
 ### :bug: Bug Fixes
 - [`2c2a788`](https://github.com/tobymao/sqlglot/commit/2c2a788bb3a5a46e7729a117a6e6b62d33beb020) - **snowflake**: COPY postfix *(PR [#3398](https://github.com/tobymao/sqlglot/pull/3398) by [@VaggelisD](https://github.com/VaggelisD))*
@@ -3448,3 +3457,4 @@ Changelog
 [v23.12.2]: https://github.com/tobymao/sqlglot/compare/v23.12.1...v23.12.2
 [v23.13.0]: https://github.com/tobymao/sqlglot/compare/v23.12.2...v23.13.0
 [v23.13.1]: https://github.com/tobymao/sqlglot/compare/v23.13.0...v23.13.1
+[v23.13.2]: https://github.com/tobymao/sqlglot/compare/v23.13.1...v23.13.2

docs/sqlglot.html

@@ -361,7 +361,7 @@ <h3 id="parser-errors">Parser Errors</h3>
 
 <h3 id="unsupported-errors">Unsupported Errors</h3>
 
-<p>It may not be possible to translate some queries between certain dialects. For these cases, SQLGlot may emit a warning and proceeds to do a best-effort translation by default. Transpilation is difficult and not all permutations are supported. If transpilation does not work, it may not be implemented yet. Well documented / tested PRs / issues are appreciated. Some transpilation cases that require db schemas are made possible through the optimizer but are not included in base transpilation:</p>
+<p>It may not be possible to translate some queries between certain dialects. For these cases, SQLGlot may emit a warning and will proceed to do a best-effort translation by default:</p>
 
 <div class="pdoc-code codehilite">
 <pre><span></span><code><span class="kn">import</span> <span class="nn">sqlglot</span>
@@ -386,6 +386,10 @@ <h3 id="unsupported-errors">Unsupported Errors</h3>
 <pre><code><a href="sqlglot/errors.html#UnsupportedError">sqlglot.errors.UnsupportedError</a>: APPROX_COUNT_DISTINCT does not support accuracy
 </code></pre>
 
+<p>There are queries that require additional information to be accurately transpiled, such as the schemas of the tables referenced in them. This is because certain transformations are type-sensitive, meaning that type inference is needed in order to understand their semantics. Even though the <code>qualify</code> and <code>annotate_types</code> optimizer <a href="https://github.com/tobymao/sqlglot/tree/main/sqlglot/optimizer">rules</a> can help with this, they are not used by default because they add significant overhead and complexity.</p>
+
+<p>Transpilation is generally a hard problem, so SQLGlot employs an "incremental" approach to solving it. This means that there may be dialect pairs that currently lack support for some inputs, but this is expected to improve over time. We highly appreciate well-documented and tested issues or PRs, so feel free to <a href="#get-in-touch">reach out</a> if you need guidance!</p>
+
 <h3 id="build-and-modify-sql">Build and Modify SQL</h3>
 
 <p>SQLGlot supports incrementally building SQL expressions:</p>

docs/sqlglot/_version.html

@@ -76,8 +76,8 @@ <h1 class="modulename">
 </span><span id="L-12"><a href="#L-12"><span class="linenos">12</span></a><span class="n">__version_tuple__</span><span class="p">:</span> <span class="n">VERSION_TUPLE</span>
 </span><span id="L-13"><a href="#L-13"><span class="linenos">13</span></a><span class="n">version_tuple</span><span class="p">:</span> <span class="n">VERSION_TUPLE</span>
 </span><span id="L-14"><a href="#L-14"><span class="linenos">14</span></a>
-</span><span id="L-15"><a href="#L-15"><span class="linenos">15</span></a><span class="n">__version__</span> <span class="o">=</span> <span class="n">version</span> <span class="o">=</span> <span class="s1">&#39;23.13.1&#39;</span>
-</span><span id="L-16"><a href="#L-16"><span class="linenos">16</span></a><span class="n">__version_tuple__</span> <span class="o">=</span> <span class="n">version_tuple</span> <span class="o">=</span> <span class="p">(</span><span class="mi">23</span><span class="p">,</span> <span class="mi">13</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
+</span><span id="L-15"><a href="#L-15"><span class="linenos">15</span></a><span class="n">__version__</span> <span class="o">=</span> <span class="n">version</span> <span class="o">=</span> <span class="s1">&#39;23.13.2&#39;</span>
+</span><span id="L-16"><a href="#L-16"><span class="linenos">16</span></a><span class="n">__version_tuple__</span> <span class="o">=</span> <span class="n">version_tuple</span> <span class="o">=</span> <span class="p">(</span><span class="mi">23</span><span class="p">,</span> <span class="mi">13</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
 </span></pre></div>
 
 
@@ -97,7 +97,7 @@ <h1 class="modulename">
                 <section id="version">
                     <div class="attr variable">
             <span class="name">version</span><span class="annotation">: str</span>        =
-<span class="default_value">&#39;23.13.1&#39;</span>
+<span class="default_value">&#39;23.13.2&#39;</span>
 
 
     </div>
@@ -109,7 +109,7 @@ <h1 class="modulename">
                 <section id="version_tuple">
                     <div class="attr variable">
             <span class="name">version_tuple</span><span class="annotation">: object</span>        =
-<span class="default_value">(23, 13, 1)</span>
+<span class="default_value">(23, 13, 2)</span>
 
 
     </div>