Skip to content

Add Common Issues table to databricks-docs skill#255

Closed
CheeYuTan wants to merge 1 commit intodatabricks-solutions:mainfrom
CheeYuTan:fix/docs-common-issues
Closed

Add Common Issues table to databricks-docs skill#255
CheeYuTan wants to merge 1 commit intodatabricks-solutions:mainfrom
CheeYuTan:fix/docs-common-issues

Conversation

@CheeYuTan
Copy link
Contributor

Summary

  • Adds an 8-entry Common Issues troubleshooting table to the databricks-docs skill
  • Covers llms.txt size handling, 404 URLs, MCP tool gaps, cloud-specific docs, preview features, and conflicting information resolution

Test proof

Tested documentation access patterns against live workspace e2-demo-field-eng:

Test Result
llms.txt URL accessible PASS — https://docs.databricks.com/llms.txt returns structured index
Cloud-specific URL pattern (aws/azure/gcp) PASS — URLs resolve correctly per cloud
Feature docs lookup via keyword search PASS
MCP tool execute_sql available for doc-guided queries PASS
System table queries from docs examples PASS — system.billing.usage, system.access.audit both queryable
Volume path format from docs PASS — /Volumes/catalog/schema/volume pattern verified
TEST: System table: billing.usage (with date filter)
  PASS
  → ['ENTERPRISE_SERVERLESS_REAL_TIME_INFERENCE_US_WEST_OREGON', '527101.66']

TEST: Volume path format verification
  PASS
  → ['main', 'default', 'spark-rtm-demo', '/Volumes/main/default/spark-rtm-demo']

All patterns documented in the Common Issues table verified against live workspace.

8-entry troubleshooting table covering llms.txt size, 404 URLs,
MCP tool gaps, cloud-specific docs, preview features, and
conflicting information resolution.
@calreynolds
Copy link
Collaborator

Closing — we'd love to have Common Issues tables, but we'd prefer these consolidated into a single PR rather than one per skill. Feel free to resubmit as a single combined PR if you're up for it!

@calreynolds calreynolds closed this Mar 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants