edits

docs/skills/zensical-docs/references/code-heavy-docs-and-mkdocstrings.md

@@ -28,13 +28,17 @@ Primary docs:
 ## Minimal Integration Pattern
 
 1. Add mkdocstrings and a Python handler package to project dependencies.
-2. Configure docs toolchain to enable mkdocstrings plugin/extension.
+2. Configure the Zensical docs toolchain to enable mkdocstrings within the site build.
 3. Create one API index page per package/domain.
 4. Expand coverage gradually from high-value modules first.
 
 General reference examples:
-- Plugin docs: https://www.mkdocs.org/user-guide/plugins/
-- Material + code/reference setup concepts: https://squidfunk.github.io/mkdocs-material/reference/
+- Zensical docs home and setup entry point: https://zensical.org/docs/
+- Zensical code blocks and authoring patterns: https://zensical.org/docs/authoring/code-blocks/
+- Zensical customization overview: https://zensical.org/docs/customization/
+
+Compatibility note:
+- Zensical is generally expected to remain compatible with MkDocs-style configuration patterns, but prefer Zensical-native documentation and examples when they cover the same behavior.
 
 ## Authoring Guidance for Docstrings
 

docs/skills/zensical-docs/references/index.md

@@ -35,8 +35,8 @@ Use this index to load only the source references needed for the current task.
 ## Related Tooling References
 
 - Markdown guide: https://www.markdownguide.org/
-- MkDocs configuration reference: https://www.mkdocs.org/user-guide/configuration/
-- Material for MkDocs setup reference: https://squidfunk.github.io/mkdocs-material/setup/
+- Zensical setup and configuration entry point: https://zensical.org/docs/
+- Zensical customization reference: https://zensical.org/docs/customization/
 - mkdocstrings: https://mkdocstrings.github.io/
 
 ## Skill-Specific Deep Dives