Skip to content

Commit 65e6853

Browse files
shirgoldbirdclaude
andauthored
Move feature comparison table to the customize overview (#414)
* Move feature comparison table to the customize overview The "Choosing the right feature" table lived on the context parameter guide, where it compared context against customization features. Move it to the customize overview, split custom instructions into its own column, and add translation memories. The context guide now links to the table instead. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Put the context parameter last in the comparison table Lead with the customization features since this is their overview page, and introduce the context parameter as the non-customization extra rather than framing the section around it. * Reword the comparison table intro * Drop redundant link location from the context guide --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent c4e78d0 commit 65e6853

2 files changed

Lines changed: 17 additions & 13 deletions

File tree

‎docs/customize/overview.mdx‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,20 @@ Glossaries, style rules, custom instructions, and translation memories work with
2323
Glossaries and style rules are unique to each of DeepL's global data centers and are not shared between them. Clients using [regional endpoints](/docs/getting-started/regional-endpoints) can't access glossaries or style rules created in the UI at this time.
2424
</Warning>
2525

26+
## Choosing the right feature
27+
28+
Here's when to use each customization feature for the best results. The [`context` parameter](/docs/learning-how-tos/examples-and-guides/how-to-use-context-parameter) can also be used to improve translations of ambiguous or short text.
29+
30+
| Use case | Glossaries | Style rules | Custom instructions | Translation memories | Context parameter |
31+
| :---- | :----: | :----: | :----: | :----: | :----: |
32+
| **Consistent domain-specific terminology** | ✅ | ❌ | ❌ | ❌ | ❌ |
33+
| **Brand and product names** | ✅ | ❌ | ❌ | ❌ | ❌ |
34+
| **Formatting conventions (dates, numbers, punctuation)** | ❌ | ✅ | ❌ | ❌ | ❌ |
35+
| **Tone and phrasing** | ❌ | ❌ | ✅ | ❌ | ❌ |
36+
| **Reusing previously approved translations** | ❌ | ❌ | ❌ | ✅ | ❌ |
37+
| **Ambiguous words or short snippets** | ❌ | ❌ | ❌ | ❌ | ✅ |
38+
| **Consistent gender or name spelling** | ❌ | ❌ | ❌ | ❌ | ✅ |
39+
2640
## Feature guides
2741

2842
<CardGroup cols={2}>

‎docs/learning-how-tos/examples-and-guides/how-to-use-context-parameter.mdx‎

Lines changed: 3 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ public: true
77
**This guide shows you:**
88
- When to use `context` (and when not to)
99
- How to use `context` to resolve ambiguous words, genders, or transliterations
10-
- How to choose between `context`, Glossaries, and Style Rules
10+
- Where to find a comparison of `context` with DeepL's customization features
1111

1212
---
1313

@@ -225,19 +225,9 @@ curl -X POST 'https://api.deepl.com/v2/translate' \
225225

226226
---
227227

228-
## Choosing the right feature for your needs
228+
## Choosing the right feature
229229

230-
Different DeepL features solve different problems. Use this table to decide which best suits your use case.
231-
232-
| Use Case | Context Parameter | Glossaries | Style Rules |
233-
|----------|:----------------:|:----------:|:-----------:|
234-
| **Ambiguous words** | ✅ | ❌ | ❌ |
235-
| **Consistent gender or spelling** | ✅ | ❌ | ❌ |
236-
| **Consistent domain-specific terminology** | ❌ | ✅ | ❌ |
237-
| **Brand names** | ❌ | ✅ | ❌ |
238-
| **Tone and style** | ❌ | ❌ | ✅ |
239-
| **Formatting rules** | ❌ | ❌ | ✅ |
240-
| **Translation instructions** | ❌ | ❌ | ✅ |
230+
The `context` parameter is one of several ways to influence translation output. For a comparison of `context` with glossaries, style rules, custom instructions, and translation memories, see [Choosing the right feature](/docs/customize/overview#choosing-the-right-feature).
241231

242232
---
243233

0 commit comments

Comments
 (0)