Skip to content

docs: audit text and localization page#16

Merged
demengc merged 1 commit intomainfrom
worktree-agent-a531184e
Mar 24, 2026
Merged

docs: audit text and localization page#16
demengc merged 1 commit intomainfrom
worktree-agent-a531184e

Conversation

@demengc
Copy link
Copy Markdown
Owner

@demengc demengc commented Mar 24, 2026

Summary

  • Rewrote the Text and Localization documentation page based on a full audit against the source API (Text.java, Translator.java, SimpleTranslator.java, Locales.java, BaseSettings.java, BaseManager.java, ConfigLocaleReader.java).
  • Restructured method references into tables for quick scanning. Verified every method name, parameter order, and return type.
  • Added previously undocumented API surface: localized(key, Locale, args), tl() overloads, localizePlaceholders overloads, localizePlaceholdersDef, addResourceBundleFromFolder, Translator.add/get/containsKey/clear/setLocale, and ConfigLocaleReader for YAML-based locale files.
  • Fixed .properties examples to use correct MessageFormat escaping ('' for literal single quotes). Removed filler comments from all code examples.

Test plan

  • Verify markdown renders correctly on GitBook
  • Confirm all code examples reference valid API methods with correct signatures
  • Check that table formatting displays properly in GitBook preview

Rewrote the Text and Localization documentation based on a full audit
of the source API. Key changes:

- Restructured all method references into tables for dense scanning
- Verified every method name, parameter order, and return type against
  Text.java and Translator.java source
- Added previously undocumented API: localized(key, Locale, args),
  tl() overloads, localizePlaceholders overloads, localizePlaceholdersDef,
  addResourceBundleFromFolder, Translator.add/get/containsKey/clear/setLocale
- Documented ConfigLocaleReader for YAML-based locale files
- Fixed .properties examples to use correct MessageFormat escaping ('')
- Removed filler comments from code examples
- Added color format comparison table
- Clarified MiniMessage mini: prefix scope (tell/coloredTell/tellLocalized/
  coloredTellLocalized only)
- Documented the ignore feature with config.yml usage pattern
@demengc demengc merged commit bf541a6 into main Mar 24, 2026
2 of 3 checks passed
@demengc demengc deleted the worktree-agent-a531184e branch March 24, 2026 02:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant