Skip to content

Commit ec0be98

Browse files
Phil Whittakerclaude
andcommitted
Improve sentence clarity in Best Practice documentation
Split all sentences over 25 words into shorter, clearer statements: - Line 23: Context sending explanation (32 → 17 + 14 words) - Line 75: Session continuity explanation (26 → 15 + 10 words) - Line 78: File saving tip (29 → 18 + 11 words) - Line 116: Prompt failure guidance (28 → 24 words) - Updated Acronyms.yml 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 6be83f9 commit ec0be98

File tree

2 files changed

+6
-5
lines changed

2 files changed

+6
-5
lines changed

.github/styles/UmbracoDocs/Acronyms.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,7 @@ exceptions:
6868
- KUDU # Azure deployment engine
6969
- LDAP # Lightweight Directory Access Protocol
7070
- LINK #
71+
- LLM # Large Language Model
7172
- MCP # Mode Context Protocol
7273
- MIT # Open-source software license developed at the Massachusetts Institute of Technology (MIT)
7374
- MDN # Mozilla Developer Network

16/umbraco-cms/reference/developer-mcp/best-practice/README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ description: Get the most out of the Umbraco CMS developer MCP server
66

77
This page details the recommended way to use the Umbraco CMS Developer MCP Server for maximum effectiveness and reliability.
88

9-
The Developer MCP Server gives you powerful fine-grained control over what the LLM can do — but to get good results, you must be deliberate about how you configure and manage for each session.
9+
The Developer MCP Server gives you powerful fine-grained control over what the LLM can do. To get good results, you must be deliberate about how you configure and manage each session.
1010

1111
## Use Only the Tools You Need
1212

@@ -20,7 +20,7 @@ Always enable only the tools (or tool collection) needed for the current task.
2020

2121
### Keep It Lean: Cost and Sustainability
2222

23-
Every time you interact with the LLM, the entire context — including the system prompt, tools, instruction files, and chat history — is sent to the model to generate a response. The smaller and more focused your context, the better.
23+
Every time you interact with the LLM, the entire context is sent to the model to generate a response. This includes the system prompt, tools, instruction files, and chat history. The smaller and more focused your context, the better.
2424

2525
Large prompts and bloated toolsets not only lead to slower and less accurate results — they also increase cost and environmental impact. The more tokens you send and receive, the higher the:
2626

@@ -72,10 +72,10 @@ If you find the context filling up too quickly or you need to pause and resume l
7272
- How far along it is
7373
- Any critical information or design decisions so far
7474

75-
You can then start a new session and reintroduce this file at the beginning to restore continuity without needing the full conversation history.
75+
You can then start a new session and reintroduce this file at the beginning. This restores continuity without needing the full conversation history.
7676

7777
{% hint style="info" %}
78-
When using Claude Code or other editor-based tools, saving progress as .md or .txt files in your repo can serve as lightweight session memory between interactions.
78+
When using Claude Code or other editor-based tools, save progress as .md or .txt files in your repo. These files can serve as lightweight session memory between interactions.
7979
{% endhint %}
8080

8181
## Use Instruction Files to Guide the Model
@@ -113,5 +113,5 @@ Offload rules, terminology, or structural constraints into a dedicated instructi
113113
Don’t try to do everything in one prompt. Sequence multi-step operations (e.g., create types → add content → apply relations) across multiple turns for better results.
114114

115115
{% hint style="info" %}
116-
If a prompt fails or produces a weak result, simplify it, restate it with clearer intent, or reduce the number of active tools and try again.
116+
If a prompt fails or produces a weak result, try these approaches: simplify it, restate it with clearer intent, or reduce the number of active tools.
117117
{% endhint %}

0 commit comments

Comments
 (0)