Fundamentals block development - landing and first pages (#56584)

* Add fundamentals of block development documentation * Remove JavaScript how-to guides and update block development fundamentals landing * Update block development fundamentals documentation * Manifest and TOC * Update block development documentation links * Update block development documentation links * restored how-to-guides javascript * Update TOC * update folder name of fundamentals section
WordPress · Nov 28, 2023 · 4494a79 · 4494a79
1 parent 0068e2a
commit 4494a79
Show file tree

Hide file tree

Showing 7 changed files with 47 additions and 1 deletion.
diff --git a/docs/getting-started/fundamentals/README.md b/docs/getting-started/fundamentals/README.md
@@ -0,0 +1,9 @@
+# Fundamentals of Block Development
+
+This section provides an introduction to the most important concepts in Block Development.
+
+In this section, you will learn:
+
+1. [**File structure of a block**](https://developer.wordpress.org/block-editor/getting-started/fundamentals/file-structure-of-a-block) - The purpose of each one of the types of files available for a block, the relationships between them, and their role in the output of the block.
+1. [**Registration of a block**](https://developer.wordpress.org/block-editor/getting-started/fundamentals/registration-of-a-block) - How a block is registered in both the server and the client.
+1. [**Javascript in the Block Editor**](https://developer.wordpress.org/block-editor/getting-started/fundamentals/javascript-in-the-block-editor) - How to work with Javascript for the Block Editor.
diff --git a/...-development/file-structure-of-a-block.md → ...fundamentals/file-structure-of-a-block.md b/...-development/file-structure-of-a-block.md → ...fundamentals/file-structure-of-a-block.md
diff --git a/...lopment/javascript-in-the-block-editor.md → ...mentals/javascript-in-the-block-editor.md b/...lopment/javascript-in-the-block-editor.md → ...mentals/javascript-in-the-block-editor.md
diff --git a/...ck-development/registration-of-a-block.md → ...d/fundamentals/registration-of-a-block.md b/...ck-development/registration-of-a-block.md → ...d/fundamentals/registration-of-a-block.md
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -95,6 +95,30 @@
 		"markdown_source": "../docs/getting-started/create-block/submitting-to-block-directory.md",
 		"parent": "create-block"
 	},
+	{
+		"title": "Fundamentals of Block Development",
+		"slug": "fundamentals",
+		"markdown_source": "../docs/getting-started/fundamentals/README.md",
+		"parent": "getting-started"
+	},
+	{
+		"title": "File structure of a block",
+		"slug": "file-structure-of-a-block",
+		"markdown_source": "../docs/getting-started/fundamentals/file-structure-of-a-block.md",
+		"parent": "fundamentals"
+	},
+	{
+		"title": "Registration of a block",
+		"slug": "registration-of-a-block",
+		"markdown_source": "../docs/getting-started/fundamentals/registration-of-a-block.md",
+		"parent": "fundamentals"
+	},
+	{
+		"title": "Working with Javascript for the Block Editor",
+		"slug": "javascript-in-the-block-editor",
+		"markdown_source": "../docs/getting-started/fundamentals/javascript-in-the-block-editor.md",
+		"parent": "fundamentals"
+	},
 	{
 		"title": "Glossary",
 		"slug": "glossary",

diff --git a/docs/reference-guides/block-api/block-metadata.md b/docs/reference-guides/block-api/block-metadata.md
@@ -78,7 +78,7 @@ Development is improved by using a defined schema definition file. Supported edi
 ```
 
 <div class="callout callout-info">
-Check <a href="/docs/getting-started/fundamentals-block-development/registration-of-a-block.md">Registration of a block</a> to learn more about how to register a block using its metadata.
+Check <a href="https://developer.wordpress.org/block-editor/getting-started/fundamentals-block-development/registration-of-a-block">Registration of a block</a> to learn more about how to register a block using its metadata.
 </div>
 
 ## Block API

diff --git a/docs/toc.json b/docs/toc.json
@@ -46,6 +46,19 @@
 					}
 				]
 			},
+			{
+				"docs/getting-started/fundamentals/README.md": [
+					{
+						"docs/getting-started/fundamentals/file-structure-of-a-block.md": []
+					},
+					{
+						"docs/getting-started/fundamentals/registration-of-a-block.md": []
+					},
+					{
+						"docs/getting-started/fundamentals/javascript-in-the-block-editor.md": []
+					}
+				]
+			},
 			{ "docs/getting-started/glossary.md": [] },
 			{ "docs/getting-started/faq.md": [] }
 		]