speced / speced/respec

Documentation on localizing ReSpec to different languages

Open
#4,796 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Feature request
Dominant language
JavaScript
Stars
806
Forks
434
Avg merge
1d 21h
Merged PRs (30d)
32

Description

We would like to localize ReSpec in Italian, but it is not very clear to us how to operate; we are proceeding in reverse-engineering mode, going to locate the strings we want to localize.

Describe the solution you'd like

Create a new article in the ReSpec guide that explains the process of localizing ReSpec to different languages. This guide should cover:

  1. Overview of ReSpec's localization capabilities
  2. Step-by-step instructions on how to add a new language
  3. Explanation of key files and structures involved in localization
  4. Best practices for maintaining translations
  5. How to contribute translations back to the main ReSpec project

Can you or your organization fund the work or help with development?

We do not know ReSpec in depth, but we can set up a draft list, based on our findings.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the existing ReSpec guide and tracing the localization structures and strings mentioned in the issue. Document the localization capabilities, language-addition process, key files, maintenance practices, and translation contribution workflow. Done means the guide gives newcomers a complete, step-by-step path for adding and maintaining a language.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.