registrystack / registrystack/registry-stack

Evaluate internationalization scope for user-facing project outputs

Open
#130 1 comment 0 reactions 0 assignees View on GitHub
agent-ready area:docs area:platform criticality:p3 documentation enhancement triage:roadmap
Dominant language
Rust
Stars
2
Forks
0
Avg merge
2h 55m
Merged PRs (30d)
130

Description

## Context

OpenSSF Best Practices silver criterion `internationalization` suggests that project software be internationalized where it generates text intended for end users or sorts human-readable text.

Registry Stack currently has English-only public docs and visible CLI/operator text. The project has not yet defined which outputs should be localizable, which outputs are operator-only, and which are out of scope.

## Scope

- Inventory user-facing and operator-facing generated text across docs, CLI, demos, and product services.
- Decide which surfaces should support localization and which are intentionally English-only for now.
- Document the decision publicly.
- If localization is in scope, define the message catalog or translation workflow before broad implementation.

## Done when

- The Best Practices `internationalization` answer has a clear public justification.
- Any future localization work has an agreed scope and implementation path.

## Non-goals

- Do not start broad translation work before the target surfaces and maintenance model are defined.

Contributor guide

Open the contributing guide

Research direction

Start by inventorying generated text across the docs, CLI, demos, and product services, then read the OpenSSF Best Practices internationalization criterion. Document which surfaces are localizable or intentionally English-only, and define the message catalog or translation workflow if localization is in scope; done means the public justification and future implementation path are agreed.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
cli, documentation, internationalization
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.