Add a document explaining the different block API versions

docs/designers-developers/developers/block-api/versions.md

@@ -0,0 +1,12 @@
+# Block API Versions
+
+This document lists the changes made between the different API versions.
+
+## Version 2 (>= WordPress 5.6)
+
+- Moves the responsibility to render the block element wrapper in the editor to the block author using the `useBlockProps()` hook.
+- Generates classnames and styles are not added automatically to the saved markup for static blocks, block authors are required to explicitely use `useBlockProps.save()` in their `save` functions to retrieve the generated classes and styles to apply on the block wrapper.
+
+## Version 1
+
+Initial version.

docs/manifest.json

@@ -149,6 +149,12 @@
 		"markdown_source": "../docs/designers-developers/developers/block-api/block-annotations.md",
 		"parent": "block-api"
 	},
+	{
+		"title": "Block API Versions",
+		"slug": "versions",
+		"markdown_source": "../docs/designers-developers/developers/block-api/versions.md",
+		"parent": "block-api"
+	},
 	{
 		"title": "Filter Reference",
 		"slug": "filters",

docs/toc.json

@@ -25,7 +25,8 @@
 			{ "docs/designers-developers/developers/block-api/block-transforms.md": [] },
 			{ "docs/designers-developers/developers/block-api/block-templates.md": [] },
 			{ "docs/designers-developers/developers/block-api/block-patterns.md": [] },
-			{ "docs/designers-developers/developers/block-api/block-annotations.md": [] }
+			{ "docs/designers-developers/developers/block-api/block-annotations.md": [] },
+			{ "docs/designers-developers/developers/block-api/versions.md": [] }
 		] },
 		{ "docs/designers-developers/developers/filters/README.md": [
 			{ "docs/designers-developers/developers/filters/block-filters.md": [] },