International Community Collaboration Strategy
#349 geöffnet am 05.04.2026
Repository-Metriken
- Stars
- (36 Sterne)
- PR-Merge-Metriken
- (PR-Metriken ausstehend)
Beschreibung
Context
Open StarTer Village is gaining traction beyond Taiwan. A Japanese community (proj-oss-boardgame) has already forked the repo, built a fully localized website at ossquest.com, and added Japanese translations for the homepage. As we move toward publishing the game online (see #348), we need a clear strategy for collaborating with external communities and welcoming international contributors.
Current Situation — Japanese Fork as Case Study
| Aspect | Status |
|---|---|
| Fork | proj-oss-boardgame/open-star-ter-village |
| Website | ossquest.com — full Japanese homepage |
| i18n work | Added ja locale, translated _pages/, _cards/, _footer/ |
| Bug fixes | HTML lang attr, 404 localization, sitemap multilang, Japanese fonts |
| Divergence | 29 commits ahead, 120 behind — repos have diverged |
| Upstream PRs | None — all work stays in the fork |
| Webapp | They removed the webapp package entirely (homepage only) |
This is a success story — a community independently adopted the project — but the lack of an upstream contribution path means both sides duplicate effort and drift apart.
Goals
- Make it easy for international communities to contribute back upstream rather than maintaining long-lived forks
- Establish a scalable i18n architecture that supports adding new locales without forking
- Define collaboration models for communities with different levels of involvement (casual translators vs. regional maintainers)
- Grow the contributor base to support the Online Launch Plan
Action Items
1. Outreach & Relationship Building
- Reach out to
proj-oss-boardgamemaintainers — understand their goals and preferred collaboration model - Discuss merging Japanese locale content upstream (keep their site as a regional deployment, not a divergent fork)
- Identify other potential communities (COSCUP international attendees, g0v international partners, university open-source programs)
2. Upstream Contribution Infrastructure
- Write a Localization Guide — step-by-step instructions for adding a new locale (folder structure, config changes, content requirements)
- Add
jalocale support tohomepage/next.config.jsupstream (accept Japanese content PRs) - Cherry-pick valuable fixes from the Japanese fork:
- HTML
langattribute fix - 404 page localization
- Sitemap multilang support
- Japanese font configuration
- HTML
- Set up CI checks for translation completeness across locales
- Create GitHub issue/PR templates for translation contributions
3. Collaboration Models
Define and document these tiers:
| Tier | Role | Example |
|---|---|---|
| Contributor | Submit translations or fixes via PR | Individual translators |
| Locale Maintainer | Own a language's content, review PRs for that locale | Japanese community lead |
| Regional Partner | Deploy a regional instance, co-maintain content | ossquest.com team |
- Document expectations, permissions, and communication channels for each tier
- Consider adding a
CODEOWNERSfile for locale-specific directories
4. Webapp i18n Foundation
- The webapp currently has zero i18n — hardcoded
lang="en", Chinese-only game data, no locale switching - Evaluate i18n framework (
next-intlor similar) for the webapp - This is a prerequisite for international communities to contribute to the game itself, not just the homepage
5. Communication & Community Building
- Create a
#internationalor#i18nchannel in Discord - Invite Japanese community members to the Discord
- Present the collaboration model at COSCUP or similar events
- Add "How to contribute translations" section to CONTRIBUTING.md