Add release notes for v0.3.0.

beeware · Jan 30, 2023 · cddb9e4 · cddb9e4
1 parent e590dae
commit cddb9e4
Show file tree

Hide file tree

Showing 65 changed files with 44 additions and 82 deletions.
diff --git a/README.rst b/README.rst
@@ -5,7 +5,7 @@
 Toga
 ====
 
-.. image:: https://img.shields.io/badge/python-3.7%20|%203.8%20|%203.9%20|%203.10-blue.svg
+.. image:: https://img.shields.io/pypi/pyversions/toga.svg
     :target: https://pypi.python.org/pypi/toga
     :alt: Python Versions
 
@@ -19,7 +19,7 @@ Toga
 
 .. image:: https://img.shields.io/pypi/l/toga.svg
     :target: https://github.com/beeware/toga/blob/main/LICENSE
-    :alt: License
+    :alt: BSD License
 
 .. image:: https://github.com/beeware/toga/workflows/CI/badge.svg?branch=main
    :target: https://github.com/beeware/toga/actions
@@ -64,7 +64,7 @@ Quickstart
 
 To get a demonstration of the capabilities of Toga, run the following::
 
-    $ pip install --pre toga-demo
+    $ pip install toga-demo
     $ toga-demo
 
 This will pop up a GUI window with some sample widgets.

diff --git a/changes/1439.bugfix.rst b/changes/1439.bugfix.rst
diff --git a/changes/1633.misc.rst b/changes/1633.misc.rst
diff --git a/changes/1638.misc.rst b/changes/1638.misc.rst
diff --git a/changes/1641.feature.rst b/changes/1641.feature.rst
diff --git a/changes/1643.misc.rst b/changes/1643.misc.rst
diff --git a/changes/1647.misc.rst b/changes/1647.misc.rst
diff --git a/changes/1648.misc.rst b/changes/1648.misc.rst
diff --git a/changes/1649.misc.rst b/changes/1649.misc.rst
diff --git a/changes/1653.misc.rst b/changes/1653.misc.rst
diff --git a/changes/1659.bugfix.rst b/changes/1659.bugfix.rst
diff --git a/changes/1660.bugfix.rst b/changes/1660.bugfix.rst
diff --git a/changes/1662.misc.rst b/changes/1662.misc.rst
diff --git a/changes/1663.misc.rst b/changes/1663.misc.rst
diff --git a/changes/1666.misc.rst b/changes/1666.misc.rst
diff --git a/changes/1669.misc.rst b/changes/1669.misc.rst
diff --git a/changes/1673.misc.rst b/changes/1673.misc.rst
diff --git a/changes/1675.misc.rst b/changes/1675.misc.rst
diff --git a/changes/1677.feature.rst b/changes/1677.feature.rst
diff --git a/changes/1681.misc.rst b/changes/1681.misc.rst
diff --git a/changes/1686.feature.rst b/changes/1686.feature.rst
diff --git a/changes/1687.misc.rst b/changes/1687.misc.rst
diff --git a/changes/1699.bugfix.rst b/changes/1699.bugfix.rst
diff --git a/changes/1700.misc.rst b/changes/1700.misc.rst
diff --git a/changes/1705.bugfix.rst b/changes/1705.bugfix.rst
diff --git a/changes/1707.misc.rst b/changes/1707.misc.rst
diff --git a/changes/1709.misc.rst b/changes/1709.misc.rst
diff --git a/changes/1710.feature.rst b/changes/1710.feature.rst
diff --git a/changes/1711.misc.rst b/changes/1711.misc.rst
diff --git a/changes/1712.misc.rst b/changes/1712.misc.rst
diff --git a/changes/1717.misc.rst b/changes/1717.misc.rst
diff --git a/changes/1720.misc.rst b/changes/1720.misc.rst
diff --git a/changes/1724.doc.rst b/changes/1724.doc.rst
diff --git a/changes/1725.bugfix.rst b/changes/1725.bugfix.rst
diff --git a/changes/1726.doc.rst b/changes/1726.doc.rst
diff --git a/changes/1728.feature.rst b/changes/1728.feature.rst
diff --git a/changes/1729.doc.rst b/changes/1729.doc.rst
diff --git a/changes/1730.misc.rst b/changes/1730.misc.rst
diff --git a/changes/1731.bugfix.rst b/changes/1731.bugfix.rst
diff --git a/changes/1733.misc.rst b/changes/1733.misc.rst
diff --git a/changes/1734.misc.rst b/changes/1734.misc.rst
diff --git a/changes/1735.misc.rst b/changes/1735.misc.rst
diff --git a/changes/1736.misc.rst b/changes/1736.misc.rst
diff --git a/changes/1737.misc.rst b/changes/1737.misc.rst
diff --git a/changes/1738.misc.rst b/changes/1738.misc.rst
diff --git a/changes/1739.misc.rst b/changes/1739.misc.rst
diff --git a/changes/1740.misc.rst b/changes/1740.misc.rst
diff --git a/changes/1741.misc.rst b/changes/1741.misc.rst
diff --git a/changes/1742.misc.rst b/changes/1742.misc.rst
diff --git a/changes/1743.misc.rst b/changes/1743.misc.rst
diff --git a/changes/1747.misc.rst b/changes/1747.misc.rst
diff --git a/changes/1748.misc.rst b/changes/1748.misc.rst
diff --git a/changes/1749.misc.rst b/changes/1749.misc.rst
diff --git a/changes/1751.misc.rst b/changes/1751.misc.rst
diff --git a/changes/1755.misc.rst b/changes/1755.misc.rst
diff --git a/changes/1756.bugfix.rst b/changes/1756.bugfix.rst
diff --git a/changes/1757.bugfix.rst b/changes/1757.bugfix.rst
diff --git a/core/setup.cfg b/core/setup.cfg
@@ -56,15 +56,17 @@ install_requires =
 packages = find:
 package_dir =
     = src
-python_requires = >= 3.6
+python_requires = >= 3.7
 zip_safe = False
 
 [options.extras_require]
 # Extras used by developers *of* briefcase are pinned to specific versions to
 # ensure environment consistency.
 dev =
     coverage[toml] == 7.0.5
-    pre-commit == 2.21.0
+    # Pre-commit 3.0 dropped support for Python 3.7
+    pre-commit == 2.21.0; python_version < "3.8"
+    pre-commit == 3.0.2; python_version >= "3.8"
     pytest == 7.2.1
     pytest-tldr == 0.2.5
     setuptools-scm[toml] == 7.0.5

diff --git a/demo/setup.cfg b/demo/setup.cfg
@@ -49,7 +49,7 @@ keywords =
 
 [options]
 packages = find:
-python_requires = >= 3.5
+python_requires = >= 3.7
 zip_safe = False
 
 [options.entry_points]

diff --git a/docs/background/releases.rst b/docs/background/releases.rst
@@ -3,12 +3,21 @@ Release History
 
 .. towncrier release notes start
 
-0.3.0
------
+0.3.0 (2023-01-30)
+==================
+
+Features
+--------
+
+* Widgets now use a three-layered (Interface/Implementation/Native) structure.
+* A GUI testing framework was added.
+* A simplified "Pack" layout algorithm was added.
+* Added a web backend.
+
+Bugfixes
+--------
 
-* Move to a three-layered Interface/Implementation/Native code structure
-* Added a test framework
-* Added a simplified "Pack" layout
+* Too many to count!
 
 0.2.15
 ------

diff --git a/docs/how-to/get-started.rst b/docs/how-to/get-started.rst
@@ -15,15 +15,10 @@ Quickstart
 
 Create a new virtualenv. In your virtualenv, install Toga, and then run it::
 
-    $ pip install toga-demo
+    $ python -m pip install toga-demo
     $ toga-demo
 
 This will pop up a GUI window showing the full range of widgets available
 to an application using Toga.
 
-There is a known issue with the current build on some Mac OS distributions. If you are
-running Mac OS Sierra or higher, use the following installation command instead::
-
-    $ pip install toga-demo --pre
-
 Have fun, and see the :ref:`reference` to learn more about what's going on.
diff --git a/docs/how-to/index.rst b/docs/how-to/index.rst
@@ -16,4 +16,4 @@ stand alone.
    Get started <get-started>
    Contribute code to Toga <contribute-code>
    Contribute documentation to Toga <contribute-docs>
-   Cut a Toga release <release>
+   internal/index
diff --git a/docs/how-to/internal/index.rst b/docs/how-to/internal/index.rst
@@ -0,0 +1,12 @@
+======================
+Internal How-to guides
+======================
+
+These guides are for the maintainers of the Toga project, documenting
+internal project procedures.
+
+.. toctree::
+   :maxdepth: 2
+   :glob:
+
+   release
diff --git a/docs/how-to/release.rst → docs/how-to/internal/release.rst b/docs/how-to/release.rst → docs/how-to/internal/release.rst
@@ -1,6 +1,6 @@
-==============================
+=========================
 How to cut a Toga release
-==============================
+=========================
 
 The release infrastructure for Toga is semi-automated, using GitHub
 Actions to formally publish releases.
@@ -34,7 +34,7 @@ The procedure for cutting a new release is as follows:
 #. Tag the release, and push the branch and tag upstream::
 
     $ git tag v1.2.3
-    $ git push upstream main
+    $ git push upstream HEAD:main
     $ git push upstream v1.2.3
 
 #. Pushing the tag will start a workflow to create a draft release on GitHub.

diff --git a/docs/tutorial/tutorial-0.rst b/docs/tutorial/tutorial-0.rst
@@ -58,7 +58,7 @@ Next, install Toga into your virtual environment:
 
     .. code-block:: bash
 
-      (venv) $ python -m pip install --pre toga
+      (venv) $ python -m pip install toga
 
   .. group-tab:: Linux
 
@@ -72,7 +72,7 @@ Next, install Toga into your virtual environment:
       (venv) $ sudo apt-get update
       (venv) $ sudo apt-get install python3-dev python3-gi python3-gi-cairo libgirepository1.0-dev libcairo2-dev libpango1.0-dev libwebkitgtk-3.0-0 gir1.2-webkit2-3.0
 
-      # Ubuntu 18.04 / Ubuntu 20.04 / Debian 10 / Debian 11
+      # Ubuntu 18.04+ / Debian 10+
       (venv) $ sudo apt-get update
       (venv) $ sudo apt-get install python3-dev python3-gi python3-gi-cairo libgirepository1.0-dev libcairo2-dev libpango1.0-dev libwebkit2gtk-4.0-37 gir1.2-webkit2-4.0
 
@@ -91,13 +91,13 @@ Next, install Toga into your virtual environment:
 
     .. code-block:: bash
 
-      (venv) $ python -m pip install --pre toga
+      (venv) $ python -m pip install toga
 
   .. group-tab:: Windows
 
     .. code-block:: doscon
 
-      (venv) C:\...>python -m pip install --pre toga
+      (venv) C:\...>python -m pip install toga
 
 If you get other errors, please check that you followed `the prerequisite
 <https://github.com/beeware/toga#prerequisites>`_ instructions.
@@ -253,7 +253,7 @@ Occasionally you might run into issues running Toga on your computer.
 Before you run the app, you'll need to install toga. Although you *can* install
 toga by just running::
 
-    $ python -m pip install --pre toga
+    $ python -m pip install toga
 
 We strongly suggest that you **don't** do this. We'd suggest creating a `virtual
 environment`_ first, and installing toga in that virtual environment as directed