diff --git a/docs/manifest.json b/docs/manifest.json index 1704e6d711510f..3ea2d844c3767c 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -497,6 +497,18 @@ "markdown_source": "../docs/reference-guides/interactivity-api/README.md", "parent": "reference-guides" }, + { + "title": "Core Concepts", + "slug": "core-concepts", + "markdown_source": "../docs/reference-guides/interactivity-api/core-concepts/README.md", + "parent": "interactivity-api" + }, + { + "title": "The Reactive and Declarative mindset", + "slug": "the-reactive-and-declarative-mindset", + "markdown_source": "../docs/reference-guides/interactivity-api/core-concepts/the-reactive-and-declarative-mindset.md", + "parent": "core-concepts" + }, { "title": "Quick start guide", "slug": "iapi-quick-start-guide", diff --git a/docs/reference-guides/interactivity-api/core-concepts/README.md b/docs/reference-guides/interactivity-api/core-concepts/README.md new file mode 100644 index 00000000000000..6c8a212437a168 --- /dev/null +++ b/docs/reference-guides/interactivity-api/core-concepts/README.md @@ -0,0 +1,5 @@ +# Core Concepts + +This section provides some guides on important concepts and mental models related to the Int block development. Use the following links to learn more: + +1. **[The Reactive and Declarative mindset](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/core-concepts/the-reactive-and-declarative-mindset):** This guide covers core concepts of reactivity and declarativeness, providing a foundation for effective use of the Interactivity API. diff --git a/docs/reference-guides/interactivity-api/core-concepts/the-reactive-and-declarative-mindset.md b/docs/reference-guides/interactivity-api/core-concepts/the-reactive-and-declarative-mindset.md index f4bd4a5b1cd5dc..3d2e475e161575 100644 --- a/docs/reference-guides/interactivity-api/core-concepts/the-reactive-and-declarative-mindset.md +++ b/docs/reference-guides/interactivity-api/core-concepts/the-reactive-and-declarative-mindset.md @@ -1,3 +1,5 @@ +# The Reactive and Declarative mindset + The Interactivity API is a reactive and declarative framework, similar to other modern frameworks like React, Vue, Svelte, or Alpine. When working with the Interactivity API, adopting the right mindset is crucial for maximizing its potential. This guide will explain the core concepts of reactivity and declarativeness, providing a foundation for effective use of the Interactivity API. ## Understanding Declarative vs. Imperative Code diff --git a/docs/toc.json b/docs/toc.json index fa80ee6c4f4404..ea412121a1f596 100644 --- a/docs/toc.json +++ b/docs/toc.json @@ -204,6 +204,13 @@ }, { "docs/reference-guides/interactivity-api/README.md": [ + { + "docs/reference-guides/interactivity-api/core-concepts/README.md": [ + { + "docs/reference-guides/interactivity-api/core-concepts/the-reactive-and-declarative-mindset.md": [] + } + ] + }, { "docs/reference-guides/interactivity-api/iapi-quick-start-guide.md": [] },