Release notes for 0.63, refs #1869

docs/changelog.rst

@@ -4,36 +4,42 @@
 Changelog
 =========
 
-.. _v0_63a1:
+.. _v0_63:
 
-0.63a1 (2022-10-23)
--------------------
+0.63 (2022-10-27)
+-----------------
 
+Features
+~~~~~~~~
+
+- Now tested against Python 3.11. Docker containers used by ``datasette publish`` and ``datasette package`` both now use that version of Python. (:issue:`1853`)
+- ``--load-extension`` option now supports entrypoints. Thanks, Alex Garcia. (`#1789 <https://github.com/simonw/datasette/pull/1789>`__)
+- Facet size can now be set per-table with the new ``facet_size`` table metadata option. (:issue:`1804`)
+- The :ref:`setting_truncate_cells_html` setting now also affects long URLs in columns. (:issue:`1805`)
+- The non-JavaScript SQL editor textarea now increases height to fit the SQL query. (:issue:`1786`)
+- Facets are now displayed with better line-breaks in long values. Thanks, Daniel Rech. (`#1794 <https://github.com/simonw/datasette/pull/1794>`__)
+- The ``settings.json`` file used in :ref:`config_dir` is now validated on startup. (:issue:`1816`)
+- SQL queries can now include leading SQL comments, using ``/* ... */`` or ``-- ...`` syntax. Thanks,  Charles Nepote. (:issue:`1860`)
 - SQL query is now re-displayed when terminated with a time limit error. (:issue:`1819`)
-- New documentation on :ref:`deploying_openrc` - thanks, Adam Simpson. (`#1825 <https://github.com/simonw/datasette/pull/1825>`__)
 - The :ref:`inspect data <performance_inspect>` mechanism is now used to speed up server startup - thanks, Forest Gregg. (:issue:`1834`)
 - In :ref:`config_dir` databases with filenames ending in ``.sqlite`` or ``.sqlite3`` are now automatically added to the Datasette instance. (:issue:`1646`)
 - Breadcrumb navigation display now respects the current user's permissions. (:issue:`1831`)
-- Screenshots in the documentation are now maintained using `shot-scraper <https://shot-scraper.datasette.io/>`__, as described in `Automating screenshots for the Datasette documentation using shot-scraper <https://simonwillison.net/2022/Oct/14/automating-screenshots/>`__. (:issue:`1844`)
-- The :ref:`datasette.check_visibility() <datasette_check_visibility>` method now accepts an optional ``permissions=`` list, allowing it to take multiple permissions into account at once when deciding if something should be shown as public or private. This has been used to correctly display padlock icons in more places in the Datasette interface. (:issue:`1829`)
 
-
-.. _v0_63a0:
-
-0.63a0 (2022-09-26)
--------------------
+Plugin hooks and internals
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 - The :ref:`plugin_hook_prepare_jinja2_environment` plugin hook now accepts an optional ``datasette`` argument. Hook implementations can also now return an ``async`` function which will be awaited automatically. (:issue:`1809`)
-- ``--load-extension`` option now supports entrypoints. Thanks, Alex Garcia. (`#1789 <https://github.com/simonw/datasette/pull/1789>`__)
-- New tutorial: `Cleaning data with sqlite-utils and Datasette <https://datasette.io/tutorials/clean-data>`__.
-- Facet size can now be set per-table with the new ``facet_size`` table metadata option. (:issue:`1804`)
-- ``truncate_cells_html`` setting now also affects long URLs in columns. (:issue:`1805`)
 - ``Database(is_mutable=)`` now defaults to ``True``. (:issue:`1808`)
-- Non-JavaScript textarea now increases height to fit the SQL query. (:issue:`1786`)
-- More detailed command descriptions on the :ref:`CLI reference <cli_reference>` page. (:issue:`1787`)
+- The :ref:`datasette.check_visibility() <datasette_check_visibility>` method now accepts an optional ``permissions=`` list, allowing it to take multiple permissions into account at once when deciding if something should be shown as public or private. This has been used to correctly display padlock icons in more places in the Datasette interface. (:issue:`1829`)
 - Datasette no longer enforces upper bounds on its dependencies. (:issue:`1800`)
-- Facets are now displayed with better line-breaks in long values. Thanks, Daniel Rech. (`#1794 <https://github.com/simonw/datasette/pull/1794>`__)
-- The ``settings.json`` file used in :ref:`config_dir` is now validated on startup. (:issue:`1816`)
+
+Documentation
+~~~~~~~~~~~~~
+
+- New tutorial: `Cleaning data with sqlite-utils and Datasette <https://datasette.io/tutorials/clean-data>`__.
+- Screenshots in the documentation are now maintained using `shot-scraper <https://shot-scraper.datasette.io/>`__, as described in `Automating screenshots for the Datasette documentation using shot-scraper <https://simonwillison.net/2022/Oct/14/automating-screenshots/>`__. (:issue:`1844`)
+- More detailed command descriptions on the :ref:`CLI reference <cli_reference>` page. (:issue:`1787`)
+- New documentation on :ref:`deploying_openrc` - thanks, Adam Simpson. (`#1825 <https://github.com/simonw/datasette/pull/1825>`__)
 
 .. _v0_62: