diff --git a/website/docs/references/models-http-api/deepseek.md b/website/docs/references/models-http-api/deepseek.md
index 5b83c24974e1..9b0bf3a6a34c 100644
--- a/website/docs/references/models-http-api/deepseek.md
+++ b/website/docs/references/models-http-api/deepseek.md
@@ -1,22 +1,21 @@
 # DeepSeek
 
-[DeepSeek](https://www.deepseek.com/) is a platform that offers a suite of AI models. Tabby supports DeepSeek's models for both code completion and chat.
-
-DeepSeek provides some OpenAI-compatible APIs, allowing us to use the OpenAI chat kinds directly.
-However, for completion, there are some differences in the implementation, so we should use the `deepseek/completion` kind.
+[DeepSeek](https://www.deepseek.com/) offers a suite of AI models, such as [DeepSeek V3](https://huggingface.co/deepseek-ai/DeepSeek-V3) and [DeepSeek Coder](https://huggingface.co/collections/deepseek-ai/deepseekcoder-v2-666bf4b274a5f556827ceeca), which perform well in coding tasks. Tabby supports DeepSeek's models for both code completion and chat.
 
 Below is an example
 
 ```toml title="~/.tabby/config.toml"
-# Chat model
+# Chat model configuration
 [model.chat.http]
+# Deepseek's chat interface is compatible with OpenAI's chat API.
 kind = "openai/chat"
 model_name = "your_model"
 api_endpoint = "https://api.deepseek.com/v1"
 api_key = "secret-api-key"
 
-# Completion model
+# Completion model configuration
 [model.completion.http]
+# Deepseek uses its own completion API interface.
 kind = "deepseek/completion"
 model_name = "your_model"
 api_endpoint = "https://api.deepseek.com/beta"