docs: update release notes

Author: rainerhahnekamp

docs/docs/release-notes/0.17.md

@@ -0,0 +1,35 @@
+---
+title: 0.17
+displayed_sidebar: releaseNotesSidebar
+---
+
+## Version 0.17
+
+The algorithm for dependency rules has been updated, which may introduce breaking changes.
+
+When a module attempts to access another module, the following steps are executed to determine if the access is allowed:
+
+- Sheriff retrieves the tags for both modules.
+- For each tag in the "from" module, Sheriff checks if it has clearance to access the corresponding tag in the "to" module.
+
+```mermaid
+stateDiagram-v2
+  [*] --> RequestAccessToModule
+  RequestAccessToModule --> GetFromAndToTags
+  GetFromAndToTags --> IterateOverFromTags
+  IterateOverFromTags --> HasFromTagAccessToAnyToTag
+  HasFromTagAccessToAnyToTag --> AccessDenied: No
+  HasFromTagAccessToAnyToTag --> MoreFromTagsAvailable: Yes
+  MoreFromTagsAvailable --> AccessGranted: No
+  MoreFromTagsAvailable --> IterateOverFromTags: Yes
+  AccessGranted --> [*]
+  AccessDenied --> [*]
+```
+
+For more information, see the [dependency rules documentation](../dependency-rules).
+
+:::note
+
+It is very likely that most applications will not be affected by this change. However, if you encounter issues, please file a bug report.
+
+:::

docs/docusaurus.config.ts

@@ -74,7 +74,7 @@ const config: Config = {
           label: 'Docs',
         },
         {
-          to: '/docs/release-notes/0.16',
+          to: '/docs/release-notes/0.17',
           label: 'Release Notes',
           position: 'left',
         },

docs/sidebars.ts

@@ -13,7 +13,7 @@ import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
 const sidebars: SidebarsConfig = {
   // By default, Docusaurus generates a sidebar from the docs folder structure
   tutorialSidebar: ['introduction', 'installation', 'module_boundaries', 'dependency-rules', 'cli', 'integration'],
-  releaseNotesSidebar: [{type: 'category', label: 'Release Notes', items: ['release-notes/0.16']}],
+  releaseNotesSidebar: [{type: 'category', label: 'Release Notes', items: ['release-notes/0.17', 'release-notes/0.16']}],
   roadmapSidebar: ['roadmap'],
 };