From 3fb904a42bfaee9cf5376ceca0fb15a1a1bfc5ed Mon Sep 17 00:00:00 2001 From: peartown Date: Mar 25 2024 23:25:58 +0000 Subject: Project request table rework in hosting.adoc + other textual changes --- diff --git a/modules/ROOT/pages/hosting.adoc b/modules/ROOT/pages/hosting.adoc index c2700b1..1bbeb1e 100644 --- a/modules/ROOT/pages/hosting.adoc +++ b/modules/ROOT/pages/hosting.adoc @@ -6,15 +6,15 @@ include::{partialsdir}/attributes.adoc[] == Fedora's online translation platform -The Fedora Project runs a web-based online translation platform powered by https://weblate.org[Weblate]. This Fedora {WEBLATE}[Weblate instance] is available at {WEBLATE} and is used by Fedora translators for translating Fedora subprojects, be it a software development project, a website or the documentation. +The Fedora Project runs a web-based online translation platform powered by https://weblate.org[Weblate software]. +This Fedora {WEBLATE}[Weblate instance] is available at {WEBLATE} and is used by Fedora translators for translating Fedora subprojects, be it a software development project, a website or the documentation. === Considerations to upstream projects -In line with the Fedora Project's vision of a world where everyone benefits from free and open source software built by inclusive, welcoming, and open-minded communities any free and open source software project is welcome to use this platform. +Any free and open source software project is welcome to use this platform. +Not only is it in line with the Fedora Project's vision of a world where everyone benefits from free and open source software built by inclusive, welcoming, and open-minded communities, but also we considered there is more motivation behind this approach, such as: -Few examples of motivation behind this approach: - -* We support any project sharing the *same xref:project:ROOT:index.adoc[values]* as the Fedora Project +* To provide a support to any project sharing the *same xref:project:ROOT:index.adoc[values]* as the Fedora Project * To improve upstream i18n support * A potential source of growth in the Fedora Community itself @@ -38,45 +38,30 @@ Rule examples: * allow translation of website and man-pages //// -== Request a new translation project on Weblate - -In spite of the effort to be open and inclusive as much as possible, some associated concerns has led us to enforce it is not possible to create a translation project in the platform for everyone: +== Request a new translation project on Fedora Weblate -* A translation of an (open source) project has to be ensured - -_Not what an individual has decided to translate._ +In spite of the effort to be open and inclusive as much as possible, some associated concerns has led us to enforce it is not possible to create a translation project in the platform by everyone: +* A translation of an (open source) project has to be ensured - _not what an individual has decided to translate._ * A project does not have to learn the weblate internals -* Configuring Weblate is not so obvious - -_Preferable is to do the first configuration for a project by us to reduce e.g. the migration costs._ - +* Configuring Weblate is not so obvious - _preferable is to do the first configuration for a project by us to reduce e.g. the migration costs._ In order to request an establishment of a new translation project in {weblate}[Weblate], open a link:https://pagure.io/fedora-l10n/tickets[ticket]. // Do we want to prepare a 'request template'? -.Project request template -==== -Project: // debbuild - -Website: //https://github.com/debbuild/debbuild - -Repository: //https://github.com/debbuild/debbuild - -Name of the development branch: - -Filemask: //po/* - -Username: //ngompa - -Optional: - -Any announcement/warning you would like to display to the translators? (it will be displayed in Weblate) - -A need to activate any specific checks? (this is a setting per component) - -A need to automatically detect new translation files? (typical usecase: website translation with one translation file per page) -==== +.Project request with example values in italics +|=== +| Project: | _debbuild_ | +| Website: | _https://github.com/debbuild/debbuild_ | +| Repository: | _https://github.com/debbuild/debbuild_ | +| Name of the development branch: | | +| Filemask: | _po/*_ | +| Username: | _ngompa_ | +| Optional: || +| Any announcement/warning you would like to display to the translators? (it will be displayed in Weblate): || +| A need to activate any specific checks? (this is a setting per component): || +| A need to automatically detect new translation files? (typical usecase: website translation with one translation file per page): || +|=== // These features has already been implemented in Weblate //// @@ -88,8 +73,8 @@ two features in Weblate to respect Fedora values: // [optional] what is the license of translation? (please use a code from https://spdx.org/licenses/) // Should we emphasize that a licence change will be notified -The specified username(s) will be set in the initial configuration of the project in Weblate as the project's administrator(s). - -Once the initial configuration is made the project contact(s) will be notified. +The specified username(s) will be set in the initial configuration of the project in Weblate as the project's administrator(s), subsequently notified about the project creation. -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'?? +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'??