From 3ae5264365e23d8f450ac00c8d6ca6ae6163f1c0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=A1n=20Tomko?= Date: Thu, 10 Mar 2022 20:08:17 +0100 Subject: [PATCH] docs: downloads: mark GitLab as the primary source MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Document our usage of GitLab and the read-only mirrors. Signed-off-by: Ján Tomko Reviewed-by: Michal Privoznik --- docs/downloads.rst | 31 +++++++++++++++++++------------ 1 file changed, 19 insertions(+), 12 deletions(-) diff --git a/docs/downloads.rst b/docs/downloads.rst index 3b36f668d7..d438166b78 100644 --- a/docs/downloads.rst +++ b/docs/downloads.rst @@ -314,24 +314,31 @@ GIT source repository --------------------- All modules maintained by the libvirt project have their primary source -available in the `project GIT server `__. Each module -can be cloned anonymously using: +available in the `libvirt group on GitLab `__. +Each module can be cloned anonymously using: + +:: + + git clone https://gitlab.com/libvirt/[module name].git + +In addition to this primary repository, there are mirrored read-only git +repositories on GitHub: + +:: + + https://github.com/libvirt/ + +And there are also read-only mirrors on libvirt.org: :: git clone https://libvirt.org/git/[module name].git -In addition to this primary repository, there are the following read-only git -repositories which mirror the master one. Note that we currently do not use the -full set of features on these mirrors (e.g. pull requests on GitHub, so please -don't use them). All patch review and discussion only occurs on the -`libvir-list `__ mailing list. Also note that some repositories -listed below allow HTTP checkouts too. +Note that for most repositories, development happens via merge requests +on GitLab. However, for the main `libvirt.git` repository all patch review and +discussion only occurs on the `libvir-list `__ mailing list. -:: - - https://github.com/libvirt/ - https://gitlab.com/libvirt/ +The GitHub repository is read-only and pull requests and issues there are ignored. Signing keys ------------