Document the scssphp upgrade (#202)

see #195

diff --git a/docs/migration/wsc54/libraries.md b/docs/migration/wsc54/libraries.md
new file mode 100644 (file)
index 0000000..44e797d
--- /dev/null
+++ b/docs/migration/wsc54/libraries.md
@@ -0,0 +1,11 @@
+# Migrating from WSC 5.4 - Third Party Libraries
+
+## scssphp
+
+scssphp was updated from version 1.4 to 1.6.
+
+If you interact with scssphp only by deploying `.scss` files, then you should not experience any breaking changes, except when the improved SCSS compatibility interprets your SCSS code differently.
+
+If you happen to directly use scssphp in your PHP code, you should be aware that scssphp deprecated the use of the `compile()` method, non-UTF-8 processing and also adjusted the handling of pure PHP values for variable handling.
+
+Refer to [WoltLab/WCF#4345](https://github.com/WoltLab/WCF/pull/4345) and the [scssphp releases](https://github.com/scssphp/scssphp/releases) for details.

diff --git a/mkdocs.yml b/mkdocs.yml
index 0568fdc2e9bcbe6299661d277f378247e2047dab..689fdebdac0dd52a96d176efa9e7e6a11ef11881 100644 (file)
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -111,6 +111,7 @@ nav:
     - 'Migrating from WSC 5.4':
       - 'PHP API': 'migration/wsc54/php.md'
       - 'TypeScript and JavaScript': 'migration/wsc54/javascript.md'
+      - 'Third Party Libraries': 'migration/wsc54/libraries.md'
       - 'Deprecations and Removals': 'migration/wsc54/deprecations_removals.md'
     - 'Migrating from WSC 5.3':
       - 'PHP API': 'migration/wsc53/php.md'