Files
AirCoding/reference/opencode-1.15.5/.opencode/glossary/README.md
AirCoding 82f3140847 Initial commit: AirCoding V1.0.0 Alpha architecture baseline
Complete architecture document set with multi-model review remediation:
- Frozen interface contracts, runtime semantics, DB schemas
- Event/tool/error/provider registries
- Scheduler and main agent state machines
- C4 module/code views, solution architecture, baseline V1
- Multi-model review reports and joint assessment
- Phase-gate remediation complete (P0/P1/P2/UX resolved)
- Implementation plan with T-000A through T-045
- Reference folders kept as placeholders only
2026-05-28 18:45:01 +08:00

2.1 KiB
Executable File

Locale Glossaries

Use this folder for locale-specific translation guidance that supplements .opencode/agent/translator.md.

The global glossary in translator.md remains the source of truth for shared do-not-translate terms (commands, code, paths, product names, etc.). These locale files capture community learnings about phrasing and terminology preferences.

File Naming

  • One file per locale
  • Use lowercase locale slugs that match docs locales when possible (for example, zh-cn.md, zh-tw.md)
  • If only language-level guidance exists, use the language code (for example, fr.md)
  • Some repo locale slugs may be aliases/non-BCP47 for consistency (for example, br for Brazilian Portuguese / pt-BR)

What To Put In A Locale File

  • Sources: PRs/issues/discussions that motivated the guidance
  • Do Not Translate (Locale Additions): locale-specific terms or casing decisions
  • Preferred Terms: recurring UI/docs words with preferred translations
  • Guidance: tone, style, and consistency notes
  • Avoid (optional): common literal translations or wording we should avoid
  • If the repo uses a locale alias slug, document the alias in Guidance (for example, prose may mention pt-BR while config/examples use br)

Prefer guidance that is:

  • Repeated across multiple docs/screens
  • Easy to apply consistently
  • Backed by a community contribution or review discussion

Template

# <locale> Glossary

## Sources

- PR #12345: https://github.com/anomalyco/opencode/pull/12345

## Do Not Translate (Locale Additions)

- `OpenCode` (preserve casing)

## Preferred Terms

| English | Preferred | Notes     |
| ------- | --------- | --------- |
| prompt  | ...       | preferred |
| session | ...       | preferred |

## Guidance

- Prefer natural phrasing over literal translation

## Avoid

- Avoid ... when ...

Contribution Notes

  • Mark entries as preferred when they may evolve
  • Keep examples short
  • Add or update the Sources section whenever you add a new rule
  • Prefer PR-backed guidance over invented term mappings; start with general guidance if no term-level corrections exist yet