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/)