You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@superset.apache.org by ru...@apache.org on 2026/09/22 01:26:06 UTC

(superset) branch master updated: docs: fix internal link guidance examples (#44275)

This is an automated email from the ASF dual-hosted git repository.

rusackas pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/superset.git


The following commit(s) were added to refs/heads/master by this push:
     new 3cbee94525d docs: fix internal link guidance examples (#44275)
3cbee94525d is described below

commit 3cbee94525de0535bf1189f66fa16fd0063b9c40
Author: Deepak Jain (DJ) <de...@users.noreply.github.com>
AuthorDate: Mon Sep 21 18:25:58 2026 -0700

    docs: fix internal link guidance examples (#44275)
    
    Signed-off-by: Deepak Jain <de...@gmail.com>
---
 docs/DOCS_CLAUDE.md | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/docs/DOCS_CLAUDE.md b/docs/DOCS_CLAUDE.md
index 9512d6eabef..ed61a30e1e2 100644
--- a/docs/DOCS_CLAUDE.md
+++ b/docs/DOCS_CLAUDE.md
@@ -304,11 +304,12 @@ import FeatureCard from '@site/src/components/FeatureCard';
 
 ### Internal Links
 
-Use relative paths for internal documentation:
+Use relative paths with explicit `.md` or `.mdx` extensions for internal
+documentation so Docusaurus can validate and resolve them:
 
 ```markdown
-[Installation Guide](./installation/docker-compose)
-[Configuration](../configuration/configuring-superset)
+[Installation Guide](./admin_docs/installation/docker-compose.mdx)
+[Configuration](./admin_docs/configuration/configuring-superset.mdx)
 ```
 
 ### External Links
@@ -587,11 +588,15 @@ FEATURE_FLAGS = {
 
 ### Cross-Referencing Pattern
 
+The following paths are relative to this guide (`docs/DOCS_CLAUDE.md`).
+Recalculate the prefix from the file being edited instead of copying it
+unchanged.
+
 ```mdx
 For detailed configuration options, see:
-- [Configuring Superset](./configuration/configuring-superset)
-- [Database Connections](./configuration/databases)
-- [Security Settings](./security/security)
+- [Configuring Superset](./admin_docs/configuration/configuring-superset.mdx)
+- [Database Connections](./docs/using-superset/creating-your-first-dashboard.mdx#connecting-to-a-new-database)
+- [Security Settings](./admin_docs/security/security.mdx)
 
 External resources:
 - [SQLAlchemy Documentation](https://docs.sqlalchemy.org/)