Skip to content

Commit b68f83c

Browse files
committed
docs: consolidate code hosting setup instructions
Move scattered pieces to a single location. Fixes #16257
1 parent f6f456a commit b68f83c

12 files changed

Lines changed: 633 additions & 454 deletions

File tree

docs/admin/code-hosting.rst

Lines changed: 486 additions & 0 deletions
Large diffs are not rendered by default.

docs/admin/config.rst

Lines changed: 18 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -901,7 +901,8 @@ List for credentials for Gitea servers.
901901

902902
.. seealso::
903903

904-
* :ref:`vcs-gitea`
904+
* :doc:`/admin/code-hosting`
905+
* :ref:`code-hosting-gitea-pull-requests`
905906
* `Creating a Gitea personal access token`_
906907

907908
.. _Creating a Gitea personal access token: https://docs.gitea.io/en-us/api-usage
@@ -932,7 +933,7 @@ List for credentials for GitLab servers.
932933

933934
.. seealso::
934935

935-
* :ref:`vcs-gitlab`
936+
* :ref:`code-hosting-gitlab-merge-requests`
936937
* `GitLab: Personal access token <https://docs.gitlab.com/user/profile/personal_access_tokens/>`_
937938

938939
.. setting:: GITHUB_CREDENTIALS
@@ -974,7 +975,7 @@ List for credentials for GitHub servers.
974975

975976
.. seealso::
976977

977-
* :ref:`vcs-github`
978+
* :ref:`code-hosting-github-pull-requests`
978979
* `Creating a GitHub personal access token`_
979980

980981
.. _Creating a GitHub personal access token: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token
@@ -1001,7 +1002,7 @@ List for credentials for Bitbucket Data Center.
10011002

10021003
.. seealso::
10031004

1004-
* :ref:`vcs-bitbucket-data-center`
1005+
* :ref:`code-hosting-bitbucket-data-center-pull-requests`
10051006
* `Bitbucket: HTTP access token <https://confluence.atlassian.com/bitbucketserver/http-access-tokens-939515499.html>`_
10061007

10071008
.. setting:: BITBUCKETCLOUD_CREDENTIALS
@@ -1040,7 +1041,7 @@ Additional settings not described here can be found at :ref:`settings-credential
10401041

10411042
.. seealso::
10421043

1043-
* :ref:`vcs-bitbucket-cloud`
1044+
* :ref:`code-hosting-bitbucket-cloud-pull-requests`
10441045
* `Create an API token <https://support.atlassian.com/bitbucket-cloud/docs/create-an-api-token/>`_
10451046
* `API token permissions <https://support.atlassian.com/bitbucket-cloud/docs/api-token-permissions/>`_
10461047

@@ -1083,7 +1084,7 @@ Additional settings not described here can be found at :ref:`settings-credential
10831084

10841085
.. seealso::
10851086

1086-
* :ref:`vcs-azure-devops`
1087+
* :ref:`code-hosting-azure-devops-pull-requests`
10871088
* `Azure DevOps: Personal access token <https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows>`_
10881089

10891090
.. setting:: GOOGLE_ANALYTICS_ID
@@ -1458,7 +1459,7 @@ List for credentials for Pagure servers.
14581459

14591460
.. seealso::
14601461

1461-
* :ref:`vcs-pagure`
1462+
* :ref:`code-hosting-pagure-merge-requests`
14621463
* `Pagure API <https://pagure.io/api/0/>`_
14631464

14641465
.. setting:: PASSWORD_MINIMAL_STRENGTH
@@ -2425,8 +2426,11 @@ VCS_API_DELAY
24252426
.. versionadded:: 4.15.1
24262427

24272428
Configures minimal delay in seconds between third-party API calls in
2428-
:ref:`vcs-github`, :ref:`vcs-gitlab`, :ref:`vcs-gitea`, :ref:`vcs-pagure`, and
2429-
:ref:`vcs-azure-devops`.
2429+
:ref:`code-hosting-github-pull-requests`,
2430+
:ref:`code-hosting-gitlab-merge-requests`,
2431+
:ref:`code-hosting-gitea-pull-requests`,
2432+
:ref:`code-hosting-pagure-merge-requests`, and
2433+
:ref:`code-hosting-azure-devops-pull-requests`.
24302434

24312435
This rate-limits API calls from Weblate to these services to avoid overloading them.
24322436

@@ -2442,8 +2446,11 @@ VCS_API_TIMEOUT
24422446
.. versionadded:: 5.15
24432447

24442448
Configures timeout in seconds for third-party API calls such as forking or
2445-
creating merge requests in :ref:`vcs-github`, :ref:`vcs-gitlab`,
2446-
:ref:`vcs-gitea`, :ref:`vcs-pagure`, and :ref:`vcs-azure-devops`.
2449+
creating merge requests in :ref:`code-hosting-github-pull-requests`,
2450+
:ref:`code-hosting-gitlab-merge-requests`,
2451+
:ref:`code-hosting-gitea-pull-requests`,
2452+
:ref:`code-hosting-pagure-merge-requests`, and
2453+
:ref:`code-hosting-azure-devops-pull-requests`.
24472454

24482455
The default value is 10.
24492456

0 commit comments

Comments
 (0)