diff --git a/docs/manifest.json b/docs/manifest.json index 1704e6d711510..3ea2d844c3767 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 0000000000000..6c8a212437a16 --- /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 f4bd4a5b1cd5d..3d2e475e16157 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 fa80ee6c4f440..ea412121a1f59 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": [] },