summaryrefslogtreecommitdiff
path: root/developers-manual.rst
diff options
context:
space:
mode:
authorbuckE <buckE@disroot.org>2020-05-05 04:03:25 +0000
committerbuckE <buckE@disroot.org>2020-05-05 04:03:25 +0000
commit478c5d2e631eee2b8efbf2abff7dad4e83fef69a (patch)
treeafc5e4404b543a3c630c30d449fc2f517d037eee /developers-manual.rst
parent61116728f510487762d5adae70b656df3f620bfb (diff)
downloaddocs-478c5d2e631eee2b8efbf2abff7dad4e83fef69a.tar.gz
docs-478c5d2e631eee2b8efbf2abff7dad4e83fef69a.tar.bz2
docs-478c5d2e631eee2b8efbf2abff7dad4e83fef69a.zip
updated Component creation info for Internationalization
Diffstat (limited to 'developers-manual.rst')
-rw-r--r--developers-manual.rst24
1 files changed, 22 insertions, 2 deletions
diff --git a/developers-manual.rst b/developers-manual.rst
index dc8142c1..cef2095c 100644
--- a/developers-manual.rst
+++ b/developers-manual.rst
@@ -621,6 +621,26 @@ Upgrading Privileges
To upgrade from **Users**/**Viewers**, a superuser must manually augment your privileges. At this time, superusers are Christian, Florian, and Buck.
+How to Create a Project
+-----------------------
+
+The *GNU Taler* project is probably the correct project for most Components and Translations falling under this guide. Please contact a superuser if you need another Project created.
+
+How to Create a Component
+-------------------------
+
+In Weblate, a *Component* is a subset of a *Project* and each Component contains N translations. A Component is generally associated with a Git repo.
+
+To create a Component, log into https://weblate.taler.net/ with your *Manager* or higher credentials and choose **+ Add* from the upper-right corner.
+
+What follows is a sort of Wizard. You can find detailed docs at https://docs.weblate.org/. Here are some important notes about connecting your Component to the Taler Git repository:
+
+* **Source code repository** - Generally `git+ssh://git@git.taler.net/<reponame>`. Check with `git remote -v`.
+* **Repository branch ** - Choose the correct branch to draw from and commit to.
+* **Repository push URL** - This is generally `git+ssh://git@git.taler.net/<reponame>` Check with `git remote -v`.
+* **Repository browser** - This is the www URL of the Git repo's file browser. Example `https://git.taler.net/<repo>.git/tree/{{filename}}#L{{line}}`
+* **Merge style ** - *Rebase*, in line with GNU Taler development procedures
+
How to Create a Translation
---------------------------
@@ -628,9 +648,9 @@ How to Create a Translation
2 - Navigate to *Projects* > *Browse all projects*
-3 - Choose the *project* you wish to contribute to.
+3 - Choose the *Project* you wish to contribute to.
-4 - Choose the *component* you wish to contribute to.
+4 - Choose the *Component* you wish to contribute to.
5 - Find the language you want to translate into. Click "Translate" on that line.