docs: clean up experiments, add some notes here and there

docs/src/docPages/experiments.md

@@ -1,14 +1,15 @@
 # Experiments
 Congratulations! You’ve found our playground with a list of experiments. Be aware that nothing here is ready to use. Feel free to play around, but please, don’t open an issue for a bug you’ve found here or send pull requests. :-)
 
-## New
+## Experimental examples
 * [Linter](/experiments/linter)
-* [Multiple editors](/experiments/multiple-editors)
+* [Content of multiple editors in a single Y.js](/experiments/multiple-editors)
 * [Global drag handle](/experiments/global-drag-handle)
-* [@tiptap/extension-slash-command?](/experiments/commands)
-* [@tiptap/extension-iframe?](/experiments/embeds)
-* [@tiptap/extension-toggle-list?](/experiments/details)
+
+## Experimental extensions
+* [@tiptap/extension-command-menu](/experiments/commands)
+* [@tiptap/extension-iframe](/experiments/embeds)
+* [@tiptap/extension-toggle-list](/experiments/details)
 * [@tiptap/extension-collaboration-annotation](/experiments/collaboration-annotation)
-* [@tiptap/extension-word-break](/experiments/word-break)
 * [@tiptap/extension-trailing-node](/experiments/trailing-node)
 * [@tiptap/extension-figure](/experiments/figure)

docs/src/docPages/experiments/commands.md

@@ -2,4 +2,7 @@
 
 ⚠️ Experiment
 
+## Issues
+* It’s fine to use, just don’t send bug reports, PRs or anything else. We’ll just need some time to publish that as an official extension.
+
 <demo name="Experiments/Commands" />

docs/src/docPages/experiments/details.md

@@ -2,4 +2,7 @@
 
 ⚠️ Experiment
 
+## Issues
+* Nested lists cause trouble
+
 <demo name="Experiments/Details" />

docs/src/docPages/experiments/embeds.md

@@ -2,4 +2,7 @@
 
 ⚠️ Experiment
 
+## Issues
+* Oh man, building a really good iframe/embed extension will take some time. The best thing to speed up the development is to [sponsor our work](/sponsor) on GitHub.
+
 <demo name="Experiments/Embeds" />

docs/src/docPages/experiments/figure.md

@@ -2,12 +2,11 @@
 
 ⚠️ Experiment
 
-## Tasks
-* Build commands to wrap an image into a figure + figcaption?
-* Build commands to unrwap figure + figcaption to an image?
-
 ## Related links
 * https://github.com/ueberdosis/tiptap/issues/573#issuecomment-730122427
 * https://discuss.prosemirror.net/t/figure-and-editable-caption/462/5
 
+## Issues
+* The current implementation works with images only.
+
 <demo name="Experiments/Figure" />

docs/src/docPages/experiments/global-drag-handle.md

@@ -2,4 +2,7 @@
 
 ⚠️ Experiment
 
+## Issues
+* We’re working on a better, more solid implementation. :) Give us some more time, and please, don’t ask when it’s ready. The best thing to speed up the development is to [sponsor our work](/sponsor) on GitHub.
+
 <demo name="Experiments/GlobalDragHandle" />

docs/src/docPages/experiments/linter.md

@@ -2,4 +2,7 @@
 
 ⚠️ Experiment
 
+## Issues
+* There is no decoration API in tiptap, that’s why this is a lot of ProseMirror work. Before we’ll publish that example, we’d need to find a few ways to make it more tiptap-like. For example, it would be great to use Vue/React components for the widget.
+
 <demo name="Experiments/Linter" />

docs/src/docPages/experiments/trailing-node.md

@@ -2,4 +2,7 @@
 
 ⚠️ Experiment
 
+## Issues
+* This implementation adds an actual node. It’d be great to use a decoration for that use case, so the document isn’t modified.
+
 <demo name="Experiments/TrailingNode" />

docs/src/docPages/experiments/word-break.md

@@ -1,5 +0,0 @@
-# Word break
-
-⚠️ Experiment
-
-<demo name="Experiments/WordBreak" />