update content

docs/src/docPages/api/schema.md

@@ -150,7 +150,7 @@ createNode({
 ```
 
 #### Selectable
-> Controls whether nodes of this type can be selected as a node selection. Defaults to true for non-text nodes.
+Besides the already visible text selection, there is an invisible node selection. If you want to make your nodes selectable, you can configure it like this:
 
 ```js
 createNode({
@@ -177,7 +177,9 @@ createNode({
 ```
 
 #### Defining
-> Determines whether this node is considered an important parent node during replace operations (such as paste). Non-defining (the default) nodes get dropped when their entire content is replaced, whereas defining nodes persist and wrap the inserted content. Likewise, in inserted content the defining parents of the content are preserved when possible. Typically, non-default-paragraph textblock types, and possibly list items, are marked as defining.
+Nodes get dropped when their entire content is replaced (for example, when pasting new content) by default. If a node should be kept for such replace operations, configure them as `defining`.
+
+Typically, that applies to [`Blockquote`](/api/extensions/blockquote), [`CodeBlock`](/api/extensions/code-block), [`Heading`](/api/extensions/heading), and [`ListItem`](/api/extensions/list-item).
 
 ```js
 createNode({

docs/src/docPages/guide/collaborative-editing.md

@@ -1,7 +1,7 @@
 # Collaborative editing
 
-:::premium Requires Premium Extensions
-Using the collaborative editing in production requires a **tiptap pro** license. [Read more](/sponsor)
+:::premium Requires Pro Extensions
+We kindly ask you to sponsor us, before using this example in production. [Read more](/sponsor)
 :::
 
 ## toc

docs/src/docPages/guide/store-content.md

@@ -92,7 +92,7 @@ That said, tiptap **does** support Markdown shortcuts to format your content. Tr
 ## Generate HTML from ProseMirror JSON
 If you need to render the content on the server side, for example to render a blog post which was written with tiptap, you’ll probably need a way to do just that without an actual editor instance.
 
-That’s what `generateHTML()` is for. It’s a utility function that renders HTML without an actual editor instance.
+That’s what `generateHTML()` is for. It’s a utility function that renders HTML without an actual editor instance. As an easy alternative, you can also use tiptap in a [read-only mode](/examples/read-only).
 
 :::info Browser-only rendering
 Import a lightweight implementation from `@tiptap/core` if you’re using the function in a browser context only.

docs/src/links.yaml

@@ -34,7 +34,7 @@
         - title: Full Editor
           link: /examples/full-editor
           draft: true
-    - title: Feedback
+    - title: Share feedback
       link: /overview/feedback
 
 - title: Guide
@@ -152,7 +152,7 @@
       link: /api/events
     - title: Schema
       link: /api/schema
-      draft: true
+      new: true
     - title: Keyboard Shortcuts
       link: /api/keyboard-shortcuts