Difference between revisions of "Weblate"

From GnuCash
Jump to: navigation, search
(Maintainer: Begin of a collection of our settings)
(Maintainer: Setup, Workflow)
Line 47: Line 47:
 
::*An explicit commit is requested.
 
::*An explicit commit is requested.
 
::*Change is older than period defined as <tt>Age of changes to commit</tt> on Component configuration.
 
::*Change is older than period defined as <tt>Age of changes to commit</tt> on Component configuration.
 +
 +
===Setup===
 +
{| class="wikitable"
 +
|-
 +
! scope="col"| WebLate Component
 +
! scope="col"| GitHub Repository/location
 +
! scope="col"| Notes
 +
|- style="vertical-align:top;"
 +
| [https://hosted.weblate.org/projects/gnucash/glossary/ Glossary]
 +
| [https://github.com/Gnucash/gnucash/tree/maint/po/glossary glossary]
 +
| linked project, part of Program
 +
 +
|- style="vertical-align:top;"
 +
| [https://hosted.weblate.org/projects/gnucash/gnucash/ Program]
 +
| [https://github.com/Gnucash/gnucash/tree/maint/po gnucash]
 +
|
 +
 +
|- style="vertical-align:top;"
 +
| [https://hosted.weblate.org/projects/gnucash/website/ Website]
 +
| [https://github.com/Gnucash/gnucash-htdocstree/master/po gnucash-htdocs]
 +
|
 +
|}
 +
 +
===Workflow===
 +
As long as Pushs of Pull Requests are not enabled, start with https://hosted.weblate.org/projects/gnucash/#repository or do it separate for real components.
 +
:;Tip: remote add weblate to your repo. Then you can preview pending commits.
 +
If there are pending commits
 +
# rebase (you need to zoom the window to see the button);
 +
# push, to create PRs;
 +
# review and merge the PRs via {{BuildServer}};
 +
# rebase. Now all lines should show 0.

Revision as of 05:25, 29 December 2020

On 2020-12-14 https://hosted.weblate.org/projects/gnucash was created.

Status
consider it still as experimental.

The page is organized by roles.

General

Many pages @ weblate link context sensitive help by i in a circle.

Weblate Documentation

Translator

Everybody
can add suggestions as anomymous.
Everybody with a weblate account
can translate and gets mentioned in the po file. In the current configuration a review is required.
Our former language maintainers
are asked to tell us their weblate name, to get Review rights.

Ideally no checks should fail. In some cases, the mistake is in the source string. Then please report them by a comment or label.

Coder

With weblate you get feedback, where Translators have problems with your messages. Overview Program Source Messages Tasks by priority:

  1. label:"Source needs review"
  2. Multiple failing checks This is usually an indication that something could be done to improve the source string. Info
Tip
In both cases at the bottom select
  1. Comments,
  2. Other languages
to get an impression of the problem.

Maintainer

Concept

Weblate is more anarchistic than our hierarchical thinking with core devs accepting or rejecting patches:

Project settings
Some are derived from our status as libre hosted project.
https://hosted.weblate.org/settings/gnucash/#access is set public meaning:
  • visible for all,
  • every registered user can translate,
  • unregistered can attach suggestions.
To avoid chaos in https://hosted.weblate.org/settings/gnucash/#workflow
  • Review is activated, ideally a Gnucash Language :Team should have at least 2 reviewers (and unlimited users), confirming each others changes.
Component settings
Suggestions are enabled, but Suggestion voting and Autoaccept suggestions are currently not.
Lazy commits
The changes in this mode are committed once any of the following conditions are fulfilled:
  • Somebody else changes an already changed string.
  • A merge from upstream occurs.
  • An explicit commit is requested.
  • Change is older than period defined as Age of changes to commit on Component configuration.

Setup

WebLate Component GitHub Repository/location Notes
Glossary glossary linked project, part of Program
Program gnucash
Website gnucash-htdocs

Workflow

As long as Pushs of Pull Requests are not enabled, start with https://hosted.weblate.org/projects/gnucash/#repository or do it separate for real components.

Tip
remote add weblate to your repo. Then you can preview pending commits.

If there are pending commits

  1. rebase (you need to zoom the window to see the button);
  2. push, to create PRs;
  3. review and merge the PRs via code.gnucash.org;
  4. rebase. Now all lines should show 0.