Warn about experimental features in the docs

website/docs/commands/export.md

@@ -17,6 +17,14 @@ You can pass it explicitly or set it globally by running:
 scala-cli config power true
 :::
 
+:::caution
+The `export` sub-command is an experimental feature.
+
+Please bear in mind that non-ideal user experience should be expected.
+If you encounter any bugs or have feedback to share, make sure to reach out to the maintenance team
+on [GitHub](https://github.com/VirtusLab/scala-cli).
+:::
+
 The project configuration is read both from information specified in source files
 as well as options passed to the `export` sub-command.
 

website/docs/commands/publishing/publish-local.md

@@ -10,6 +10,14 @@ You can pass it explicitly or set it globally by running:
     scala-cli config power true
 :::
 
+:::caution
+The `publish local` sub-command is an experimental feature.
+
+Please bear in mind that non-ideal user experience should be expected.
+If you encounter any bugs or have feedback to share, make sure to reach out to the maintenance team
+on [GitHub](https://github.com/VirtusLab/scala-cli).
+:::
+
 import {ChainedSnippets} from "../../../src/components/MarkdownComponents.js";
 
 The `publish local` sub-command publishes a Scala CLI project in the local Ivy2

website/docs/commands/publishing/publish-setup.md

@@ -10,6 +10,14 @@ You can pass it explicitly or set it globally by running:
     scala-cli config power true
 :::
 
+:::caution
+The `publish setup` sub-command is an experimental feature.
+
+Please bear in mind that non-ideal user experience should be expected.
+If you encounter any bugs or have feedback to share, make sure to reach out to the maintenance team
+on [GitHub](https://github.com/VirtusLab/scala-cli).
+:::
+
 import {ChainedSnippets} from "../../../src/components/MarkdownComponents.js";
 
 The `publish setup` sub-command configures your project for publishing to Maven repositories,

website/docs/commands/publishing/publish.md

@@ -10,6 +10,14 @@ You can pass it explicitly or set it globally by running:
     scala-cli config power true
 :::
 
+:::caution
+The `publish` sub-command is an experimental feature.
+
+Please bear in mind that non-ideal user experience should be expected.
+If you encounter any bugs or have feedback to share, make sure to reach out to the maintenance team
+on [GitHub](https://github.com/VirtusLab/scala-cli).
+:::
+
 import {ChainedSnippets} from "../../../src/components/MarkdownComponents.js";
 
 The `publish` sub-command allows to publish Scala CLI projects to Maven repositories.

website/docs/guides/markdown.md

@@ -1,8 +1,16 @@
 ---
-title: Markdown (experimental) ⚡️
+title: Markdown ⚡️
 sidebar_position: 60
 ---
 
+:::caution
+Markdown support is an experimental feature.
+
+Please bear in mind that non-ideal user experience should be expected.
+If you encounter any bugs or have feedback to share, make sure to reach out to the maintenance team
+on [GitHub](https://github.com/VirtusLab/scala-cli).
+:::
+
 import {ChainedSnippets} from "../../src/components/MarkdownComponents.js";
 
 Scala CLI can compile, run, test, and package markdown (`.md`) sources.

website/docs/guides/sbt-mill.md

@@ -3,6 +3,14 @@ title: SBT and Mill ⚡️
 sidebar_position: 50
 ---
 
+:::caution
+The `export` sub-command is an experimental feature.
+
+Please bear in mind that non-ideal user experience should be expected.
+If you encounter any bugs or have feedback to share, make sure to reach out to the maintenance team
+on [GitHub](https://github.com/VirtusLab/scala-cli).
+:::
+
 Scala CLI lets you export your current build into sbt or Mill.
 This means that if your project needs something that Scala CLI doesn’t provide — such as a second module — you can export your project to your build tool of choice.