From 1646e10518a1a6356c58b4578672b65641f9c033 Mon Sep 17 00:00:00 2001 From: peartown Date: Mar 25 2024 23:26:12 +0000 Subject: Modify hosting.adoc - Add 'Project configuration good practice' chapter --- diff --git a/modules/ROOT/pages/hosting.adoc b/modules/ROOT/pages/hosting.adoc index c15f848..14d7c9c 100644 --- a/modules/ROOT/pages/hosting.adoc +++ b/modules/ROOT/pages/hosting.adoc @@ -78,4 +78,23 @@ The specified username(s) will be set in the initial configuration of the projec Request made by upstream projects will be reviewed on an individual basis upon submission of the ticket. Priority will be given to projects that create software packaged for Fedora. -// or 'by Fedora'?? + +== Project configuration good practice + +Once the requested translation project is created for you in Weblate, you can continue with https://docs.weblate.org/en/latest/admin/projects.html[setting] its other options. +There are several approaches to creating a project's components, for example. +Weblate provides different means to recieve and send changes between Weblate and your repository, so it is hard task to cover all possibilies here or prepare a common guide. +But what we have learned from helping to set various projects: + +Do not forget to set, if appropriate, a https://docs.weblate.org/en/latest/api.html#notification-hooks[webhook] in the project options in order to automatically receive changes from your VCS, such as + +---- +https://translate.fedoraproject.org/hooks/pagure //for Pagure +https://translate.fedoraproject.org/hooks/gitlab //for GitLab +https://translate.fedoraproject.org/hooks/github //for GitHub +---- + +Weblate is able to https://docs.weblate.org/en/latest/admin/continuous.html#pushing-changes-from-weblate[push translations] to your repository by setting 'Repository push URL' option of a component configuration. +For GitHub there is https://github.com/weblate[Weblate user] which should be given a commit access to the repository. +The same applies for GitLab. +For Pagure there is https://pagure.io/user/weblatebot[weblatebot user].