docs: updates to reflect product simplifications #7357

TyDunn · 2025-08-22T23:49:11Z

closes ty/con-3393

Summary by cubic

Cleaned up and simplified the docs by removing outdated pages, updating links/copy to current flows, and adding redirects to prevent 404s. This clarifies “user settings” references and aligns guides with current features.

Refactors
- Removed outdated pages: User Settings, Build Your Own Context Provider, Llama 3.1, Codestral setup, and Hub Bundles.
- Updated links/copy to current targets: user settings (telemetry), customize/custom-providers, Ollama guide, and Mistral provider page; removed obsolete guide references across chat/context and hub docs.
- Trimmed navigation and added redirects in docs.json so old URLs (e.g., /customize/settings, /guides/llama3.1, /hub/blocks/bundles) go to maintained pages.

Patrick-Erichsen

Didn't see any overlap with Hub updates.

docs/customize/deep-dives/custom-providers.mdx

bdougie

Went through the each page and audited it live on the url. I am happy with all these changes and will be nice to have a fresh start with our new focus on agents and a clean up of some deprecated features.

I'll wait for @RomneyDa to take a technical look at the changes, but I think the majority of the changes are known deprecation removals and name changes (block removal).

bdougie · 2025-08-28T18:36:24Z

I'll wait for @RomneyDa to take a technical look at the changes, but I think the majority of the changes are known deprecation removals and name changes (block removal).

Just saw @Patrick-Erichsen already approved. I think we are good to move forward

RomneyDa

Vast improvements! Added some nitpicks. The only main non-nitpick thing is that I wonder if we shouldn't replace actual model names/slugs with <MODEL_NAME> everywhere, because it removes the user one level from being able to use the config directly. I wonder if we should use Mintlify features to have a select that populates the YAML with examples or similar

RomneyDa · 2025-08-28T18:25:25Z

docs/hub/introduction.mdx


-Continue Hub also makes it easy for engineering leaders to centrally [configure](/hub/secrets/secret-types) and [govern](/hub/governance/org-permissions) blocks and assistants for their organization.
+- **[Models](/hub/blocks/block-types#models)**: Discover and configure models from various providers
+- **[MCP Tools](/hub/blocks/block-types#mcp-servers)**: Access and integrate Model Context Protocol tools to retrieve real-time data and take action


one case that still says tools

RomneyDa · 2025-08-28T18:36:25Z

docs/customization/mcp-tools.mdx

@@ -1,20 +1,20 @@
 ---
-title: "MCP Blocks"
+title: "MCP servers"


nitpick but several points throughout PR where I think "servers" should be capitalized when in a title

RomneyDa · 2025-08-28T18:36:50Z

docs/customization/mcp-tools.mdx


-## Learn More About MCP Blocks
+## Learn More About MCP servers


RomneyDa · 2025-08-28T20:32:15Z

docs/customize/deep-dives/custom-providers.mdx

Doesn't make sense to me to call this "custom providers", they're more like "manual context providers".

RomneyDa · 2025-08-28T20:34:02Z

docs/customize/model-providers/top-level/azure.mdx

 <Tabs>
  <Tab title="YAML">
  ```yaml title="config.yaml"
  models:
-    - name: GPT-4o
+    - name: <Model_NAME>


BekahHW · 2025-08-28T17:36:00Z

docs/customization/mcp-tools.mdx

@@ -1,20 +1,20 @@
 ---
-title: "MCP Blocks"
+title: "MCP servers"


Suggested change

title: "MCP servers"

title: "MCP Servers"

BekahHW · 2025-08-28T17:36:44Z

docs/customization/mcp-tools.mdx


-## Learn More About MCP Blocks
+## Learn More About MCP servers


Suggested change

## Learn More About MCP servers

## Learn More About MCP Servers

BekahHW · 2025-08-28T17:40:13Z

docs/customization/models.mdx

-| Embed        | [Nomic Embed Text](https://hub.continue.dev/ollama/nomic-embed-text-latest), Qwen3 Embedding                                                     | [Voyage Code 3](https://hub.continue.dev/voyageai/voyage-code-3), [Morph Embeddings](https://hub.continue.dev/morphllm/morph-embedding-v2), Codestral Embed                                                                                                    | Closed models are slightly better than open models                           |
-| Rerank       | zerank-1, zerank-1-small, Qwen3 Reranker                                                                                                         | [Voyage Rerank 2.5](https://hub.continue.dev/voyageai/rerank-2-5), Relace Code Rerank, [Morph Rerank](https://hub.continue.dev/morphllm/morph-rerank-v2)                                                                                                       | Open models are beginning to emerge for this model role                      |
-| Next Edit    | Zeta                                                                                                                                             | Mercury Coder                                                                                                                                                                                                                                                  | Closed models are significantly better than open models                      |
+| Agent / Plan | [Qwen3 Coder (480B)](https://hub.continue.dev/openrouter/qwen3-coder), [Qwen3 Coder (30B)](https://hub.continue.dev/ollama/qwen3-coder-30b), [Devstral (27B)](https://hub.continue.dev/ollama/devstral), [Kimi K2 (1T)](https://hub.continue.dev/openrouter/kimi-k2), [gpt-oss (120B)](https://hub.continue.dev/openrouter/gpt-oss-120b), [gpt-oss (20B)](https://hub.continue.dev/ollama/gpt-oss-20b), GLM 4.5 (355B), GLM 4.5 Air (106B) | [Claude Opus 4.1](https://hub.continue.dev/anthropic/claude-4-1-opus), [Claude Sonnet 4](https://hub.continue.dev/anthropic/claude-4-sonnet), [GPT-5](https://hub.continue.dev/openai/gpt-5), [Gemini 2.5 Pro](https://hub.continue.dev/google/gemini-2.5-pro) | Closed models are slightly better than open models                           |


I'm not sure if your PR will get merged in before mine, but I created a reusable component for recommendations that we'll use instead of the md table, so we only need to update in one place.

we will need to update your pr once this gets merged

BekahHW · 2025-08-28T20:54:41Z

docs/docs.json

@@ -210,8 +195,7 @@
                  "hub/blocks/intro",


Are we removing the terminology "blocks" altogether? I see that we're still using it some places in the hub.

- https://hub.continue.dev/new?type=block&blockType=models&createFor=agent

Are the docs ahead of the hub? I'm really wondering if this section needs rewritten or removed.

hub has already been updated

BekahHW

Just a couple of small changes. Looks good.

sestinj · 2025-09-01T22:48:03Z

🎉 This PR is included in version 1.12.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

sestinj · 2025-09-03T22:55:40Z

🎉 This PR is included in version 1.12.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

remove outdated pages and references to them

de19d62

github-project-automation bot added this to Issues and PRs Aug 22, 2025

github-project-automation bot moved this to Todo in Issues and PRs Aug 22, 2025

TyDunn added 2 commits August 22, 2025 16:54

change telemetry to a page instead of a directory with one page

2e361c5

fix duplicate redirects

2bd2189

mintlify bot deployed to staging - docs August 23, 2025 00:16 View deployment

remove vs code actions docs and references

ec733c3

mintlify bot deployed to staging - docs August 23, 2025 01:40 View deployment

update hub introduction

3ee0b91

mintlify bot deployed to staging - docs August 23, 2025 01:45 View deployment

deprecate some context providers

960be0c

mintlify bot deployed to staging - docs August 23, 2025 01:57 View deployment

initial codebase and documentation guide

832b227

mintlify bot deployed to staging - docs August 23, 2025 02:13 View deployment

replace context provider with MCP in custom code RAG

1b05573

mintlify bot deployed to staging - docs August 23, 2025 02:21 View deployment

deprecate @docs and @codebase

c4297f0

mintlify bot deployed to staging - docs August 23, 2025 02:45 View deployment

remove context, docs, data blocks

d8fc9bc

mintlify bot deployed to staging - docs August 23, 2025 03:03 View deployment

TyDunn added 4 commits August 25, 2025 15:19

move context providers to deep dives

f2f7a8f

move custom providers

8d7f1fc

remove "blocks"

1300d38

remove rules "block"

1a37a29

mintlify bot deployed to staging - docs August 25, 2025 22:26 View deployment

update popular providers

d822fff

mintlify bot deployed to staging - docs August 26, 2025 01:17 View deployment

cleanup before review

df2bc91

mintlify bot deployed to staging - docs August 27, 2025 18:06 View deployment

updating more providers

b761b77

TyDunn added 2 commits August 27, 2025 22:28

reorder referene section

7a2f593

update block types

0d930ca

mintlify bot deployed to staging - docs August 28, 2025 05:31 View deployment

adjust model config example

89fa397

mintlify bot deployed to staging - docs August 28, 2025 05:32 View deployment

Patrick-Erichsen reviewed Aug 28, 2025

View reviewed changes

docs/customize/deep-dives/custom-providers.mdx Outdated Show resolved Hide resolved

fix tabs for yaml / json

607c459

mintlify bot deployed to staging - docs August 28, 2025 17:55 View deployment

bdougie mentioned this pull request Aug 28, 2025

fix: Add ModelRecommendations component for central updating #7457

Merged

3 tasks

bdougie previously approved these changes Aug 28, 2025

View reviewed changes

github-project-automation bot moved this from Todo to In Progress in Issues and PRs Aug 28, 2025

dosubot bot added the lgtm This PR has been approved by a maintainer label Aug 28, 2025

RomneyDa reviewed Aug 28, 2025

View reviewed changes

BekahHW requested changes Aug 28, 2025

View reviewed changes

dosubot bot removed the lgtm This PR has been approved by a maintainer label Aug 28, 2025

BekahHW previously approved these changes Aug 28, 2025

View reviewed changes

dosubot bot added the lgtm This PR has been approved by a maintainer label Aug 28, 2025

Merge branch 'main' into docs/simplify-and-add-agent-awareness-guide

81f6d5b

bdougie dismissed stale reviews from BekahHW and themself via 81f6d5b August 28, 2025 22:21

bdougie approved these changes Aug 28, 2025

View reviewed changes

mintlify bot deployed to staging - docs August 28, 2025 22:23 View deployment

bdougie merged commit 9f68638 into main Aug 28, 2025
57 checks passed

bdougie deleted the docs/simplify-and-add-agent-awareness-guide branch August 28, 2025 22:33

github-project-automation bot moved this from In Progress to Done in Issues and PRs Aug 28, 2025

github-actions bot locked and limited conversation to collaborators Aug 28, 2025

sestinj added the released label Sep 1, 2025


		## Learn More About MCP Blocks
		## Learn More About MCP servers

docs: updates to reflect product simplifications #7357

docs: updates to reflect product simplifications #7357

Uh oh!

Conversation

TyDunn commented Aug 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by cubic

Uh oh!

Patrick-Erichsen left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

bdougie left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

bdougie commented Aug 28, 2025

Uh oh!

RomneyDa left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

BekahHW left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

sestinj commented Sep 1, 2025

Uh oh!

sestinj commented Sep 3, 2025

Uh oh!

Uh oh!

TyDunn commented Aug 22, 2025 •

edited

Loading

bdougie left a comment •

edited

Loading