diff --git a/src/oss/javascript/migrate/langchain-v1.mdx b/src/oss/javascript/migrate/langchain-v1.mdx
index b9460883b..19a3ad1b9 100644
--- a/src/oss/javascript/migrate/langchain-v1.mdx
+++ b/src/oss/javascript/migrate/langchain-v1.mdx
@@ -188,7 +188,7 @@ await agent.invoke({
 
 ### Pre-model hook
 
-Pre-model hooks are now implemented as middleware with the `beforeModel` method. This pattern is more extensible-- you can define multiple middlewares to run before the model is called and reuse them across agents.
+Pre-model hooks are now implemented as middleware with the `beforeModel` method. This pattern is more extensible--you can define multiple middlewares to run before the model is called and reuse them across agents.
 
 Common use cases include:
 - Summarizing conversation history
diff --git a/src/oss/python/migrate/langchain-v1.mdx b/src/oss/python/migrate/langchain-v1.mdx
index 9e6448f06..faa21c280 100644
--- a/src/oss/python/migrate/langchain-v1.mdx
+++ b/src/oss/python/migrate/langchain-v1.mdx
@@ -15,7 +15,7 @@ The `langchain` package namespace has been significantly reduced in v1 to focus
 |-------------------------|------------------------------------------------|-----------------------------------|
 | @[`langchain.agents`]      | @[`create_agent`], @[`AgentState`]                   | Core agent creation functionality |
 | @[`langchain.messages`]    | Message types, @[content blocks][ContentBlock], @[`trim_messages`] | Re-exported from `langchain-core` |
-| @[`langchain.tools`]       | @[`tool`], @[`BaseTool`], injection helpers          | Re-exported from `langchain-core` |
+| @[`langchain.tools`]       | @[`@tool`], @[`BaseTool`], injection helpers          | Re-exported from `langchain-core` |
 | @[`langchain.chat_models`] | @[`init_chat_model`], @[`BaseChatModel`]             | Unified model initialization      |
 | @[`langchain.embeddings`]  | @[`init_embeddings`], @[`Embeddings`]                | Embedding models                  |
 
@@ -235,7 +235,7 @@ agent.invoke(
 ### Pre-model hook
 
 Pre-model hooks are now implemented as middleware with the `before_model` method.
-This new pattern is more extensible-- you can define multiple middlewares to run before the model is called,
+This new pattern is more extensible--you can define multiple middlewares to run before the model is called,
 reusing common patterns across different agents.
 
 Common use cases include:
@@ -279,7 +279,7 @@ agent = create_react_agent(
 ### Post-model hook
 
 Post-model hooks are now implemented as middleware with the `after_model` method.
-This new pattern is more extensible-- you can define multiple middlewares to run after the model is called,
+This new pattern is more extensible--you can define multiple middlewares to run after the model is called,
 reusing common patterns across different agents.
 
 Common use cases include:
@@ -788,7 +788,7 @@ The `langchain` package namespace has been significantly reduced in v1 to focus
 |-------------------------|------------------------------------------------|-----------------------------------|
 | @[`langchain.agents`]      | @[`create_agent`], @[`AgentState`]                   | Core agent creation functionality |
 | @[`langchain.messages`]    | Message types, @[content blocks][ContentBlock], @[`trim_messages`] | Re-exported from `langchain-core` |
-| @[`langchain.tools`]       | @[`tool`], @[`BaseTool`], injection helpers          | Re-exported from `langchain-core` |
+| @[`langchain.tools`]       | @[`@tool`], @[`BaseTool`], injection helpers          | Re-exported from `langchain-core` |
 | @[`langchain.chat_models`] | @[`init_chat_model`], @[`BaseChatModel`]             | Unified model initialization      |
 | @[`langchain.embeddings`]  | @[`init_embeddings`], @[`Embeddings`]                | Embedding models                  |