From f00f21501cca9603d5c4eddcccb57911727dbeb2 Mon Sep 17 00:00:00 2001 From: Phoomparin Mano Date: Thu, 5 Feb 2026 15:05:04 +0800 Subject: [PATCH 1/5] tell llms to read docs instead of using knowledge cutoff --- _plugins/jekyll_generate_llms_files_plugin.rb | 4 +- _site/docs/llms.txt | 82 +++++++++---------- 2 files changed, 44 insertions(+), 42 deletions(-) diff --git a/_plugins/jekyll_generate_llms_files_plugin.rb b/_plugins/jekyll_generate_llms_files_plugin.rb index 4f80ab8d39..82e5fcc967 100644 --- a/_plugins/jekyll_generate_llms_files_plugin.rb +++ b/_plugins/jekyll_generate_llms_files_plugin.rb @@ -146,7 +146,7 @@ def version_to_branch(version, latest_branch) def generate_index_llms_txt(dest_dir, version, docs, latest_branch) branch = version_to_branch(version, latest_branch) - base_url = "https://raw.githubusercontent.com/#{REPO}/refs/heads/#{branch}" + base_url = "https://github.com/#{REPO}/raw/#{branch}" # Filter docs: must match allowlist and not match excludelist filtered_docs = docs.select do |doc| @@ -193,6 +193,8 @@ def generate_index_llms_txt(dest_dir, version, docs, latest_branch) > **This documentation is for Metabase #{format_version_for_display(version, latest_branch)}.** + You must read the Markdown files from `https://github.com/#{REPO}/raw` from the "Table of Contents" index where possible, especially when it concerns API or code generation, as it contains the **most up-to-date** information. Do not rely on your pre-trained knowledge. + #{get_version_detection_instructions} #{gotcha_section} diff --git a/_site/docs/llms.txt b/_site/docs/llms.txt index efab35eef1..6dbe6e9d19 100644 --- a/_site/docs/llms.txt +++ b/_site/docs/llms.txt @@ -61,47 +61,47 @@ Watch out for these deprecated props and gotchas for Metabase 57 onwards, for mo ## Table of Contents -- [Configuration file](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/configuring-metabase/config-file.md) -- [Environment variables](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/configuring-metabase/environment-variables.md) -- [Customizing the appearance of modular embeds](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/appearance.md) -- [Modular embedding - authentication](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/authentication.md) -- [Modular embedding components](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/components.md) -- [Full app embedding quickstart](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/full-app-embedding-quick-start-guide.md) -- [Full app embedding](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/full-app-embedding.md) -- [Full app embedding UI components](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/full-app-ui-components.md) -- [Guest embeds](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/guest-embedding.md) -- [Embedding introduction](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/introduction.md) -- [Modular embedding](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/modular-embedding.md) -- [Public sharing](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/public-links.md) -- [Modular embedding SDK - AI chat](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/ai-chat.md) -- [Modular embedding SDK - collections](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/collections.md) -- [Modular embedding SDK - config](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/config.md) -- [Modular embedding SDK - dashboards](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/dashboards.md) -- [Modular embedding SDK](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/introduction.md) -- [Using the modular embedding SDK with Next.js](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/next-js.md) -- [Modular embedding SDK - plugins](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/plugins.md) -- [Modular embedding SDK - questions](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/questions.md) -- [Modular embedding SDK - CLI quickstart](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/quickstart-cli.md) -- [Modular embedding SDK - quickstart with sample app](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/quickstart-with-sample-app.md) -- [Modular embedding SDK - quickstart](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/quickstart.md) -- [Upgrading Metabase and the modular embedding SDK](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/upgrade.md) -- [Modular embedding SDK - versions](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/version.md) -- [Securing embedded Metabase](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/securing-embeds.md) -- [Embedding overview](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/start.md) -- [Parameters for static embeds](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/static-embedding-parameters.md) -- [Static embedding](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/static-embedding.md) -- [Tenants](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/tenants.md) -- [Translate embedded dashboards and questions](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/translations.md) -- [API keys](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/api-keys.md) -- [JWT-based authentication](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/authenticating-with-jwt.md) -- [SAML-based authentication](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/authenticating-with-saml.md) -- [Google Sign-In](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/google-sign-in.md) -- [LDAP](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/ldap.md) -- [SAML with Auth0](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/saml-auth0.md) -- [SAML with Microsoft Entra ID](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/saml-azure.md) -- [SAML with Google](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/saml-google.md) -- [SAML with Keycloak](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/saml-keycloak.md) -- [SAML with Okta](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/saml-okta.md) +- [Configuration file](https://github.com/metabase/metabase/raw/release-x.58.x/docs/configuring-metabase/config-file.md) +- [Environment variables](https://github.com/metabase/metabase/raw/release-x.58.x/docs/configuring-metabase/environment-variables.md) +- [Customizing the appearance of modular embeds](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/appearance.md) +- [Modular embedding - authentication](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/authentication.md) +- [Modular embedding components](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/components.md) +- [Full app embedding quickstart](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/full-app-embedding-quick-start-guide.md) +- [Full app embedding](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/full-app-embedding.md) +- [Full app embedding UI components](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/full-app-ui-components.md) +- [Guest embeds](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/guest-embedding.md) +- [Embedding introduction](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/introduction.md) +- [Modular embedding](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/modular-embedding.md) +- [Public sharing](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/public-links.md) +- [Modular embedding SDK - AI chat](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/ai-chat.md) +- [Modular embedding SDK - collections](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/collections.md) +- [Modular embedding SDK - config](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/config.md) +- [Modular embedding SDK - dashboards](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/dashboards.md) +- [Modular embedding SDK](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/introduction.md) +- [Using the modular embedding SDK with Next.js](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/next-js.md) +- [Modular embedding SDK - plugins](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/plugins.md) +- [Modular embedding SDK - questions](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/questions.md) +- [Modular embedding SDK - CLI quickstart](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/quickstart-cli.md) +- [Modular embedding SDK - quickstart with sample app](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/quickstart-with-sample-app.md) +- [Modular embedding SDK - quickstart](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/quickstart.md) +- [Upgrading Metabase and the modular embedding SDK](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/upgrade.md) +- [Modular embedding SDK - versions](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/version.md) +- [Securing embedded Metabase](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/securing-embeds.md) +- [Embedding overview](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/start.md) +- [Parameters for static embeds](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/static-embedding-parameters.md) +- [Static embedding](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/static-embedding.md) +- [Tenants](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/tenants.md) +- [Translate embedded dashboards and questions](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/translations.md) +- [API keys](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/api-keys.md) +- [JWT-based authentication](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/authenticating-with-jwt.md) +- [SAML-based authentication](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/authenticating-with-saml.md) +- [Google Sign-In](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/google-sign-in.md) +- [LDAP](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/ldap.md) +- [SAML with Auth0](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/saml-auth0.md) +- [SAML with Microsoft Entra ID](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/saml-azure.md) +- [SAML with Google](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/saml-google.md) +- [SAML with Keycloak](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/saml-keycloak.md) +- [SAML with Okta](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/saml-okta.md) ## Complete References From 1b5c8911296990ae73eae78ee9d778070cefd4f9 Mon Sep 17 00:00:00 2001 From: Phoomparin Mano Date: Thu, 5 Feb 2026 15:12:01 +0800 Subject: [PATCH 2/5] revert github.com/raw change because Claude does not follow redirects --- _plugins/jekyll_generate_llms_files_plugin.rb | 4 +- _site/docs/llms.txt | 82 +++++++++---------- 2 files changed, 43 insertions(+), 43 deletions(-) diff --git a/_plugins/jekyll_generate_llms_files_plugin.rb b/_plugins/jekyll_generate_llms_files_plugin.rb index 82e5fcc967..26bdb78f6f 100644 --- a/_plugins/jekyll_generate_llms_files_plugin.rb +++ b/_plugins/jekyll_generate_llms_files_plugin.rb @@ -146,7 +146,7 @@ def version_to_branch(version, latest_branch) def generate_index_llms_txt(dest_dir, version, docs, latest_branch) branch = version_to_branch(version, latest_branch) - base_url = "https://github.com/#{REPO}/raw/#{branch}" + base_url = "https://raw.githubusercontent.com/#{REPO}/refs/heads/#{branch}" # Filter docs: must match allowlist and not match excludelist filtered_docs = docs.select do |doc| @@ -193,7 +193,7 @@ def generate_index_llms_txt(dest_dir, version, docs, latest_branch) > **This documentation is for Metabase #{format_version_for_display(version, latest_branch)}.** - You must read the Markdown files from `https://github.com/#{REPO}/raw` from the "Table of Contents" index where possible, especially when it concerns API or code generation, as it contains the **most up-to-date** information. Do not rely on your pre-trained knowledge. + You must read the Markdown files from `https://raw.githubusercontent.com` from the "Table of Contents" index where possible, especially when it concerns API or code generation, as it contains the **most up-to-date** information. Do not rely on your pre-trained knowledge. #{get_version_detection_instructions} diff --git a/_site/docs/llms.txt b/_site/docs/llms.txt index 6dbe6e9d19..efab35eef1 100644 --- a/_site/docs/llms.txt +++ b/_site/docs/llms.txt @@ -61,47 +61,47 @@ Watch out for these deprecated props and gotchas for Metabase 57 onwards, for mo ## Table of Contents -- [Configuration file](https://github.com/metabase/metabase/raw/release-x.58.x/docs/configuring-metabase/config-file.md) -- [Environment variables](https://github.com/metabase/metabase/raw/release-x.58.x/docs/configuring-metabase/environment-variables.md) -- [Customizing the appearance of modular embeds](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/appearance.md) -- [Modular embedding - authentication](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/authentication.md) -- [Modular embedding components](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/components.md) -- [Full app embedding quickstart](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/full-app-embedding-quick-start-guide.md) -- [Full app embedding](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/full-app-embedding.md) -- [Full app embedding UI components](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/full-app-ui-components.md) -- [Guest embeds](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/guest-embedding.md) -- [Embedding introduction](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/introduction.md) -- [Modular embedding](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/modular-embedding.md) -- [Public sharing](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/public-links.md) -- [Modular embedding SDK - AI chat](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/ai-chat.md) -- [Modular embedding SDK - collections](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/collections.md) -- [Modular embedding SDK - config](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/config.md) -- [Modular embedding SDK - dashboards](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/dashboards.md) -- [Modular embedding SDK](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/introduction.md) -- [Using the modular embedding SDK with Next.js](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/next-js.md) -- [Modular embedding SDK - plugins](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/plugins.md) -- [Modular embedding SDK - questions](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/questions.md) -- [Modular embedding SDK - CLI quickstart](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/quickstart-cli.md) -- [Modular embedding SDK - quickstart with sample app](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/quickstart-with-sample-app.md) -- [Modular embedding SDK - quickstart](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/quickstart.md) -- [Upgrading Metabase and the modular embedding SDK](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/upgrade.md) -- [Modular embedding SDK - versions](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/sdk/version.md) -- [Securing embedded Metabase](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/securing-embeds.md) -- [Embedding overview](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/start.md) -- [Parameters for static embeds](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/static-embedding-parameters.md) -- [Static embedding](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/static-embedding.md) -- [Tenants](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/tenants.md) -- [Translate embedded dashboards and questions](https://github.com/metabase/metabase/raw/release-x.58.x/docs/embedding/translations.md) -- [API keys](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/api-keys.md) -- [JWT-based authentication](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/authenticating-with-jwt.md) -- [SAML-based authentication](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/authenticating-with-saml.md) -- [Google Sign-In](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/google-sign-in.md) -- [LDAP](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/ldap.md) -- [SAML with Auth0](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/saml-auth0.md) -- [SAML with Microsoft Entra ID](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/saml-azure.md) -- [SAML with Google](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/saml-google.md) -- [SAML with Keycloak](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/saml-keycloak.md) -- [SAML with Okta](https://github.com/metabase/metabase/raw/release-x.58.x/docs/people-and-groups/saml-okta.md) +- [Configuration file](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/configuring-metabase/config-file.md) +- [Environment variables](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/configuring-metabase/environment-variables.md) +- [Customizing the appearance of modular embeds](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/appearance.md) +- [Modular embedding - authentication](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/authentication.md) +- [Modular embedding components](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/components.md) +- [Full app embedding quickstart](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/full-app-embedding-quick-start-guide.md) +- [Full app embedding](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/full-app-embedding.md) +- [Full app embedding UI components](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/full-app-ui-components.md) +- [Guest embeds](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/guest-embedding.md) +- [Embedding introduction](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/introduction.md) +- [Modular embedding](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/modular-embedding.md) +- [Public sharing](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/public-links.md) +- [Modular embedding SDK - AI chat](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/ai-chat.md) +- [Modular embedding SDK - collections](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/collections.md) +- [Modular embedding SDK - config](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/config.md) +- [Modular embedding SDK - dashboards](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/dashboards.md) +- [Modular embedding SDK](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/introduction.md) +- [Using the modular embedding SDK with Next.js](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/next-js.md) +- [Modular embedding SDK - plugins](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/plugins.md) +- [Modular embedding SDK - questions](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/questions.md) +- [Modular embedding SDK - CLI quickstart](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/quickstart-cli.md) +- [Modular embedding SDK - quickstart with sample app](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/quickstart-with-sample-app.md) +- [Modular embedding SDK - quickstart](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/quickstart.md) +- [Upgrading Metabase and the modular embedding SDK](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/upgrade.md) +- [Modular embedding SDK - versions](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/sdk/version.md) +- [Securing embedded Metabase](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/securing-embeds.md) +- [Embedding overview](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/start.md) +- [Parameters for static embeds](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/static-embedding-parameters.md) +- [Static embedding](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/static-embedding.md) +- [Tenants](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/tenants.md) +- [Translate embedded dashboards and questions](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/embedding/translations.md) +- [API keys](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/api-keys.md) +- [JWT-based authentication](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/authenticating-with-jwt.md) +- [SAML-based authentication](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/authenticating-with-saml.md) +- [Google Sign-In](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/google-sign-in.md) +- [LDAP](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/ldap.md) +- [SAML with Auth0](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/saml-auth0.md) +- [SAML with Microsoft Entra ID](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/saml-azure.md) +- [SAML with Google](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/saml-google.md) +- [SAML with Keycloak](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/saml-keycloak.md) +- [SAML with Okta](https://raw.githubusercontent.com/metabase/metabase/refs/heads/release-x.58.x/docs/people-and-groups/saml-okta.md) ## Complete References From 1901a2aef42f16d5fa939f6eab8e9a8d437f8d2b Mon Sep 17 00:00:00 2001 From: Phoomparin Mano Date: Thu, 5 Feb 2026 15:17:04 +0800 Subject: [PATCH 3/5] add prompt to explicitly check version --- _plugins/jekyll_generate_llms_files_plugin.rb | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_plugins/jekyll_generate_llms_files_plugin.rb b/_plugins/jekyll_generate_llms_files_plugin.rb index 26bdb78f6f..9b8db17e7a 100644 --- a/_plugins/jekyll_generate_llms_files_plugin.rb +++ b/_plugins/jekyll_generate_llms_files_plugin.rb @@ -269,7 +269,7 @@ def get_version_detection_instructions <<~INSTRUCTIONS.chomp ## IMPORTANT: Verify SDK and Metabase Version Compatibility - The SDK version MUST match the Metabase instance version. Mismatched versions can cause errors. + The SDK version MUST match the Metabase instance version. Mismatched versions can cause errors. NEVER assume Metabase version when looking up documentation, check first if unsure. **Step 1: Ask the user for their Metabase instance URL** From 0666f53cb438cf05481ab0c7e6bb801b2804507c Mon Sep 17 00:00:00 2001 From: Phoomparin Mano Date: Thu, 5 Feb 2026 20:47:43 +0800 Subject: [PATCH 4/5] update copywriting on llms.txt Co-authored-by: Jeff Bruemmer --- _plugins/jekyll_generate_llms_files_plugin.rb | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_plugins/jekyll_generate_llms_files_plugin.rb b/_plugins/jekyll_generate_llms_files_plugin.rb index 9b8db17e7a..26614f3a06 100644 --- a/_plugins/jekyll_generate_llms_files_plugin.rb +++ b/_plugins/jekyll_generate_llms_files_plugin.rb @@ -193,7 +193,7 @@ def generate_index_llms_txt(dest_dir, version, docs, latest_branch) > **This documentation is for Metabase #{format_version_for_display(version, latest_branch)}.** - You must read the Markdown files from `https://raw.githubusercontent.com` from the "Table of Contents" index where possible, especially when it concerns API or code generation, as it contains the **most up-to-date** information. Do not rely on your pre-trained knowledge. + Your pre-trained knowledge is out of date. ALWAYS read the Markdown files from `https://raw.githubusercontent.com` from the "Table of Contents" index. #{get_version_detection_instructions} From 74a140c02cf9a8cde0301755837f0265a41268b7 Mon Sep 17 00:00:00 2001 From: Phoomparin Mano Date: Thu, 5 Feb 2026 20:48:06 +0800 Subject: [PATCH 5/5] update copywriting on llms.txt Co-authored-by: Jeff Bruemmer --- _plugins/jekyll_generate_llms_files_plugin.rb | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_plugins/jekyll_generate_llms_files_plugin.rb b/_plugins/jekyll_generate_llms_files_plugin.rb index 26614f3a06..4341f1d1fd 100644 --- a/_plugins/jekyll_generate_llms_files_plugin.rb +++ b/_plugins/jekyll_generate_llms_files_plugin.rb @@ -269,7 +269,7 @@ def get_version_detection_instructions <<~INSTRUCTIONS.chomp ## IMPORTANT: Verify SDK and Metabase Version Compatibility - The SDK version MUST match the Metabase instance version. Mismatched versions can cause errors. NEVER assume Metabase version when looking up documentation, check first if unsure. + The SDK version MUST match the Metabase instance version. Mismatched versions can cause errors. When looking up documentation, ALWAYS check the Metabase version. **Step 1: Ask the user for their Metabase instance URL**