🚀 Release v0.2.0 (#9)

Author: ubmarco

docs/conf.py

@@ -24,6 +24,7 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
 extensions = [
+    "sphinx.ext.extlinks",
     "sphinx_needs",
 ]
 
@@ -69,3 +70,11 @@
 
 # Sphinx-Needs configuration
 needs_from_toml = "ubproject.toml"
+
+extlinks = {
+    "pr": ("https://github.com/useblocks/needs-config-writer/pull/%s", "PR #%s"),
+    "issue": (
+        "https://github.com/useblocks/needs-config-writer/issues/%s",
+        "issue #%s",
+    ),
+}

docs/development/changelog.rst

@@ -3,10 +3,40 @@
 Changelog
 =========
 
-.. _unreleased:
+..
+   .. _unreleased:
 
-Unreleased
-----------
+   Unreleased
+   ----------
+
+.. _`release:0.2.0`:
+
+0.2.0
+-----
+
+:Released: 28.10.2025
+:Full Changelog: `v0.1.0...v0.2.0 <https://github.com/useblocks/needs-config-writer/compare/0.1.0...e457d2f>`__
+
+This release reduce the complexity of content comparison and improves the configuration.
+It's not backwards compatible as most of the configuration changed. Please check the updated documentation.
+
+- ♻️ Remove hash based comparison (:pr:`8`)
+
+  The configuration ``needscfg_use_hash`` was renamed to :ref:`config_warn_on_diff`.
+  Hashing is not required as the content can be compared directly.
+  This is simpler with less config and less dependencies.
+  Default is ``True``.
+
+  :ref:`config_overwrite` now checks in all cases whether to overwrite differing files.
+  Default is ``False`` to prevent accidental overwrites.
+
+  The configuration ``needscfg_write_defaults`` was renamed to :ref:`config_write_all`
+  to be more explicit about what it does. If enabled, all known Sphinx-Needs configuration is written,
+  including defaults and not only explicitly set values.
+  Default is ``False``.
+
+  Fix sorting of ``needs_extra_options`` which maybe given as ``list[str]`` or ``list[dict]``.
+  For the latter case it is sorted by the ``name`` key.
 
 .. _`release:0.1.0`:
 

needs_config_writer/__init__.py

@@ -1,6 +1,6 @@
 """Sphinx extension to write Sphinx-Needs config to ubproject.toml."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 
 
 def setup(app):

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "needs-config-writer"
-version = "0.1.0"
+version = "0.2.0"
 description = "Sphinx extension to write Sphinx-Needs config to ubproject.toml"
 readme = "README.rst"
 urls.Repository = "https://github.com/useblocks/needs-config-writer"