Help center: Ask AI & Markdown rendering

src/_data/sidebar.yml

@@ -64,6 +64,8 @@ help:
         link: /documentation-experience/markdown-support/
       - label: Topics
         link: /documentation-experience/topics/
+      - label: Ask AI & Markdown rendering
+        link: /documentation-experience/ask-ai-markdown-rendering/
   - type: category
     label: Customization Options
     link: /customization-options/
@@ -154,4 +156,4 @@ help:
     icon: help-circle
   - label: Support and SLA
     link: /support-and-sla/
-    icon: heart-plus
+    icon: heart-plus

src/_data/sidebars/help.yml

@@ -70,6 +70,8 @@ resources:
         link: /documentation-experience/markdown-support/
       - label: Topics
         link: /documentation-experience/topics/
+      - label: Ask AI & Markdown rendering
+        link: /documentation-experience/ask-ai-markdown-rendering/
   - type: category
     label: Customization Options
     link: /customization-options/

src/_help/documentation-experience/ask-ai-markdown-rendering.md

@@ -0,0 +1,75 @@
+---
+title: Ask AI & Markdown rendering
+---
+
+- TOC
+{:toc}
+
+Markdown version of your API docs and hubs, optimized for AI tools, are offered next to your standard docs. These Markdown versions, by providing narrowed-down contexts, reduce token cost and hallucinations, therefore returning more relevant results. 
+
+## Ask AI
+Many API consumers now rely on AI tools to help them quickly discover API capabilities. The `Ask AI` dropdown menu offers documentation users easy access to ChatGPT and Claude, alongside a one-click Markdown access.
+
+![ask-ai-dropdown.png](/images/help/ask-ai-dropdown.png)
+
+## Markdown rendering
+To access the Markdown version of a documentation, add `.md` at the end of the URL (or `/source.md` if you have a custom domain, when the URL is the root of your documentation).
+
+[On a documentation root](https://developers.bump.sh/source.md) *(example truncated for visibility purposes).*
+```markdown
+# Bump.sh Api
+
+## Description
+This is version `1.0` of this API documentation. Last update on Jun 16, 2025.
+This is the official Bump.sh API documentation. Obviously created with Bump.sh.
+
+The Bump.sh API is a REST API. It enables you to [...]
+
+
+## Servers
+- https://bump.sh/api/v1: https://bump.sh/api/v1 ()
+
+
+## Endpoints
+- [Branches](https://developers.bump.sh/group/endpoint-branches.md)
+- [Diffs](https://developers.bump.sh/group/endpoint-diffs.md)
+- [...]
+
+
+## Webhooks
+- [Documentation change](https://developers.bump.sh/group/webhook-documentation-change.md)
+````
+
+[For a specific operation](https://developers.bump.sh/operation/operation-post-versions.md) *(example truncated for visibility purposes).*
+```markdown
+# Create a new version
+
+**POST /versions**
+
+Deploy a new version for a given documentation, which will become the current version.
+
+
+## Servers
+- https://bump.sh/api/v1: https://bump.sh/api/v1 ()
+
+
+## Authentication methods
+- Authorization token
+- Basic token
+
+
+## Body parameters
+Content-type: application/json
+The version creation request object
+- **documentation** (string)
+  UUID or slug of the documentation.
+- [...]
+
+## Responses
+### 201: Documentation version successfully created
+
+#### Body Parameters: application/json (object)
+- **id** (string)
+  Unique id of your version.
+- [...]
+```