docs: add changelog in the documentation

Author: azmeuk

CHANGES.rst

@@ -1,73 +1,52 @@
-Changes
-=======
-
 Version 0.x
 -----------
 
 - Stop support for python 3.6 and 3.7. Start support for python3
-  3.11 and 3.12. (`#41`)
+  3.11 and 3.12. (:pr:`41`)
+-  ``render_kw`` support (:pr:`42`)
+-  ``optgroup`` support (:pr:`44`)
+-  SQLAlchemy 2.0 support (:pr:`45`)
 
 Version 0.3
 -----------
 
 Released on November 6th, 2021
 
--  Wtforms 3 support. (`#35`_)
--  SQLAlchemy 1.4 tests fixes. (`#34`_)
--  Switched from Travis CI to Github Actions (`#33`_)
--  Abandon deperecated validator. (`#32`_)
--  Stop support for python < 3.8; start support for python 3.12 (`#41`_)
--  ``render_kw`` support (`#42`_)
--  ``optgroup`` support (`#44`_)
--  SQLAlchemy 2.0 support (`#45`_)
+-  Wtforms 3 support. (:pr:`35`)
+-  SQLAlchemy 1.4 tests fixes. (:pr:`34`)
+-  Switched from Travis CI to Github Actions (:pr:`33`)
+-  Abandon deperecated validator. (:pr:`32`)
 
 Version 0.2
 -----------
 
 Released on June 21st, 2020
 
 -   Auto-generated ``DecimalField`` does not limit places for ``Float``
-    columns. (`#2`_)
--   Add an example of using this library with Flask-SQAlchemy. (`#3`_)
+    columns. (:pr:`2`)
+-   Add an example of using this library with Flask-SQAlchemy. (:pr:`3`)
 -   Generating a form from a model copies any lists of validators
     passed in ``field_args`` to prevent modifying a shared value across
-    forms. (`#5`_)
+    forms. (:pr:`5`)
 -   Don't add a ``Length`` validator when the column's length is not an
-    int. (`#6`_)
+    int. (:pr:`6`)
 -   Add ``QueryRadioField``, like ``QuerySelectField`` except
     it renders a list of radio fields. Add ``QueryCheckboxField``, like
     ``QuerySelectMultipleField`` except it renders a list of checkbox
-    fields. (`#8`_)
+    fields. (:pr:`8`)
 -   Fix a compatibility issue with SQLAlchemy 2.1 that caused
-    ``QuerySelectField`` to fail with a ``ValueError``. (`#9`_, `#10`_,
-    `#11`_)
+    ``QuerySelectField`` to fail with a ``ValueError``. (:issue:`9`, :pr:`10`,
+    :pr:`11`)
 -   QuerySelectField.query allowing no results instead of falling back to
-    ``query_factory``. (`#15`_)
--   Explicitly check if db_session is None in converter. (`#17`_)
+    ``query_factory``. (:pr:`15`)
+-   Explicitly check if db_session is None in converter. (:pr:`17`)
 -   Check for ``sqlalchemy.`` to avoid matching packages with names starting
     with ``sqlalchemy`` (6237a0f_)
--   Use SQLAlchemy's Column.doc for WTForm's Field.description (`#21`_)
--   Stopped support for python < 3.5 and added a style pre-commit hook. (`#23`_)
--   Documentation cleanup. (`#24`_)
+-   Use SQLAlchemy's Column.doc for WTForm's Field.description (:pr:`21`)
+-   Stopped support for python < 3.5 and added a style pre-commit hook. (:pr:`23`)
+-   Documentation cleanup. (:pr:`24`)
 
-.. _#2: https://github.com/wtforms/wtforms-sqlalchemy/pull/2
-.. _#3: https://github.com/wtforms/wtforms-sqlalchemy/pull/3
-.. _#5: https://github.com/wtforms/wtforms-sqlalchemy/pull/5
-.. _#6: https://github.com/wtforms/wtforms-sqlalchemy/pull/6
-.. _#8: https://github.com/wtforms/wtforms-sqlalchemy/pull/8
-.. _#9: https://github.com/wtforms/wtforms-sqlalchemy/issues/9
-.. _#10: https://github.com/wtforms/wtforms-sqlalchemy/pull/10
-.. _#11: https://github.com/wtforms/wtforms-sqlalchemy/pull/11
-.. _#15: https://github.com/wtforms/wtforms-sqlalchemy/pull/15
-.. _#17: https://github.com/wtforms/wtforms-sqlalchemy/pull/17
 .. _6237a0f: https://github.com/wtforms/wtforms-sqlalchemy/commit/6237a0f9e53ec5f22048be7f129e29f7f1c58448
-.. _#21: https://github.com/wtforms/wtforms-sqlalchemy/pull/21
-.. _#23: https://github.com/wtforms/wtforms-sqlalchemy/pull/23
-.. _#24: https://github.com/wtforms/wtforms-sqlalchemy/pull/24
-.. _#32: https://github.com/wtforms/wtforms-sqlalchemy/pull/32
-.. _#33: https://github.com/wtforms/wtforms-sqlalchemy/pull/33
-.. _#34: https://github.com/wtforms/wtforms-sqlalchemy/pull/34
-.. _#35: https://github.com/wtforms/wtforms-sqlalchemy/pull/35
 
 Version 0.1
 -----------

docs/changes.rst

@@ -0,0 +1,4 @@
+Changes
+=======
+
+.. include:: ../CHANGES.rst

docs/index.rst

@@ -12,6 +12,7 @@ Contents:
    :maxdepth: 2
 
    wtforms_sqlalchemy
+   changes
 
 
 Indices and tables