updates from review

bidi47 · bidi47 · commit d06b0a0a8f04 · 2026-05-21T12:23:00.000+03:00
Signed-off-by: bidi &lt;bidi@apidemia.com&gt;
diff --git a/docs/book/v7/architecture-at-a-glance.md b/docs/book/v7/architecture-at-a-glance.md
diff --git a/docs/book/v7/extended-features/core-and-app.md b/docs/book/v7/extended-features/core-and-app.md
@@ -7,8 +7,8 @@ Because of that, your platform needs to be flexible and allow growth in the long
 
 Our purpose is to reach a **Headless Platform** architecture for easier scalability.
 
-> The Headless Platform is a backend-only content management system that acts primarily as a content repository.
-> Compared to traditional CMS platforms (e.g., WordPress) that tightly couple the front end and back end, a Headless Platform decouples the content management from the presentation layer.
+> The Headless Platform is a backend system that provides data and functionality via an API, completely decoupled from any frontend presentation layer.
+> Unlike monolithic platforms like WordPress that bundle the backend and frontend together, a Headless Platform separates content delivery from the presentation layer.
 > The content is delivered through APIs allowing any frontend to fetch and display it, which also enables working in parallel on the backend and potentially multiple frontends.
 
 ## What is "App" and what is "Core"?
diff --git a/docs/book/v7/introduction/introduction.md b/docs/book/v7/introduction/introduction.md
@@ -133,6 +133,6 @@ Ready to get started?
 
 - Jump to the [Installation Guide](https://docs.dotkernel.org/api-documentation/v7/installation/getting-started/) to set up your first Dotkernel API application.
 - Learn the [Upgrade Procedure](https://docs.dotkernel.org/api-documentation/v7/upgrading/upgrading/) between different versions of Dotkernel API.
-- Check out the [Architecture at a Glance](https://docs.dotkernel.org/api-documentation/v7/introduction/architecture-at-a-glance/).
+- Check out the [Architecture at a Glance](https://docs.dotkernel.org/api-documentation/v7/architecture-at-a-glance/).
 - Review the [Core Features](https://docs.dotkernel.org/api-documentation/v7/core-features/authentication/).
 - Run through the [Tutorials](https://docs.dotkernel.org/api-documentation/v7/tutorials/cors/) for step-by-step instructions on how to use Dotkernel API.
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -12,7 +12,7 @@ nav:
   - Home: index.md
   - v7:
       - Introduction: v7/introduction/introduction.md
-      - "Architecture at a Glance": v7/introduction/architecture-at-a-glance.md
+      - "Architecture at a Glance": v7/architecture-at-a-glance.md
       - Overview:
           - "Server Requirements": v7/introduction/server-requirements.md
           - "File Structure": v7/introduction/file-structure.md
