nextcloud / nextcloud/docker-ci

Allow translations of changelogs

Open
#878 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement transifex
Dominant language
Perl
Stars
45
Forks
37
Avg merge
3d 1h
Merged PRs (30d)
8

Description

According to the dev documentation, add developers can provide a changelog to their users. This will (eventually) be shown to the users and can be localized/translated.

While app devs typically do not need to worry about the translations due to the nice translation system and integration into transifex, the changelog is currently handled manually. While this is cumbersome it also includes the risk that the translations are not present or not of high quality (as done by the devs themselves).

I would add a feature request to allow devs to opt-in to (user) changelog translations.

For simpler parsing, this might be done using something like po4a that allows to gettextify different files. Alternatively, one could think of a way to register plain synchronization endpoint and let the devs create an appropriate integration.

I just want to put this here into discussion. If it is considered superior to use e.g. intro.js and create the user documentation using plain js (which is then translatable as normal in-app translations).

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 with the linked developer documentation and compare the proposed po4a and synchronization-endpoint approaches. Done means the issue has a decided opt-in translation workflow for app developers and a clear way for translated changelogs to reach users.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
localization
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
28/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.