Infrastructure/Github Mirror: Difference between revisions

From KDE Community Wiki
(Add information about where the *actual* KDE repositories are to be found)
(space in top level heading)
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=GitHubMirror=
=GitHub Mirror=


KDE is managing a '''read-only''' <b>mirror</b> of [https://commits.kde.org our repos] on Github. It's located at https://github.com/KDE .
KDE is managing a '''read-only''' <b>mirror</b> of [https://commits.kde.org our repos] on Github. It's located at https://github.com/KDE .
Line 14: Line 14:
Also as an open source project, it's very important for us to keep to using open source tools. Github does not meet that requirement.
Also as an open source project, it's very important for us to keep to using open source tools. Github does not meet that requirement.


==How do I submit "Pull Requests"?==
==How do I submit “Pull Requests”?==


KDE is in the process of moving many projects from [https://phabricator.kde.org/ Phabricator], our old code-management tool, to [https://invent.kde.org/ GitLab]. Currently some projects are still hosted on Phabricator while others are hosted on Gitlab.
To determine which tool should be used for a particular project:
# Look at the project's documentation (README.md, wiki page, etc.). It should tell you how the project wants to accept patches.
#* Unfortunately, some projects documentation still needs updating.
# Look at the listings of projects on [https://invent.kde.org/ KDE GitLab]. If the project is there, that is most likely where patches should be uploaded.
#* Check and see if there are already merge requests on GitLab. If there are some, it is a pretty certain sign that the project is using GitLab.
# Ask the project developers. We are always happy to talk with potential contributors and point you in the right direction!
Follow the instructions below depending on which patch-uploading tool the project uses:
=== For Projects using GitLab ===
The process of using GitLab is very similar to using GitHub.
* Log in to [https://invent.kde.org/ KDE's GitLab]
* Fork the repository of the project you want to work on
* Make a branch in your fork
* Make changes, commit them to your branch, and push
* When you push you should be given a link to easily make a merge request. If not, navigate to your fork on GitLab and make a pull request from there
=== For Projects using Phabricator ===
* Fork and commit your changes in your fork as before
* Fork and commit your changes in your fork as before
* Create an account on https://identity.kde.org
* Create an account on https://identity.kde.org
Line 25: Line 45:
The maintainer for this software will then comment and merge your request.
The maintainer for this software will then comment and merge your request.


Alternatively you can use the command "arc diff" to streamline the process. More details are available in the [https://community.kde.org/Infrastructure/Phabricator#Using_Arcanist_to_post_patches Phabricator] page.
Alternatively you can use the command <code>arc diff</code> to streamline the process. More details are available in the [https://community.kde.org/Infrastructure/Phabricator#Using_Arcanist_to_post_patches Phabricator] page.
 
==How do I submit "Issues"?==
 
Please file a bug report or wish at https://bugs.kde.org


==Where can I find the “original” sources?==
==How do I submit “Issues”?==


All KDE GIT repositories are available for browsing at https://cgit.kde.org/ with each repository including possible ''git clone'' URLs at the bottom of their respective summary pages. The general command format for cloning a repository being:
Please file a bug report or wish at https://bugs.kde.org/


<code>git clone (https|git)://anongit.kde.org/<repository>.git</code>
==Where can I find the “original sources”?==


Additionally to the top-level repositories mostly mirrored on GitHub so-called scratch and clone repositories exist for allowing KDE developers to publish repositories without jumping through organizational hurdles.
All KDE Git repositories are available for browsing at https://invent.kde.org/.


For details on KDE's GIT infrastructure see [https://community.kde.org/Infrastructure/Git the dedicated GIT infrastructure page].
For details on KDE's Git infrastructure see [https://community.kde.org/Infrastructure/Git the dedicated GIT infrastructure page].

Revision as of 20:09, 18 June 2020

GitHub Mirror

KDE is managing a read-only mirror of our repos on Github. It's located at https://github.com/KDE .

We want to make KDE sources easy to find, share and build upon; and most importantly we want your contributions to count towards your github profile. :)

FAQ

Why don't you enable pull requests?

Our central repositories are handled by our awesome sysadmins over on kde.org where we have full control and tighter integration within our services. If we start using multiple repositories and making developers look in two places that gets very complicated and unfair on the maintainers.

Also as an open source project, it's very important for us to keep to using open source tools. Github does not meet that requirement.

How do I submit “Pull Requests”?

KDE is in the process of moving many projects from Phabricator, our old code-management tool, to GitLab. Currently some projects are still hosted on Phabricator while others are hosted on Gitlab.

To determine which tool should be used for a particular project:

  1. Look at the project's documentation (README.md, wiki page, etc.). It should tell you how the project wants to accept patches.
    • Unfortunately, some projects documentation still needs updating.
  2. Look at the listings of projects on KDE GitLab. If the project is there, that is most likely where patches should be uploaded.
    • Check and see if there are already merge requests on GitLab. If there are some, it is a pretty certain sign that the project is using GitLab.
  3. Ask the project developers. We are always happy to talk with potential contributors and point you in the right direction!

Follow the instructions below depending on which patch-uploading tool the project uses:

For Projects using GitLab

The process of using GitLab is very similar to using GitHub.

  • Log in to KDE's GitLab
  • Fork the repository of the project you want to work on
  • Make a branch in your fork
  • Make changes, commit them to your branch, and push
  • When you push you should be given a link to easily make a merge request. If not, navigate to your fork on GitLab and make a pull request from there

For Projects using Phabricator


The maintainer for this software will then comment and merge your request.

Alternatively you can use the command arc diff to streamline the process. More details are available in the Phabricator page.

How do I submit “Issues”?

Please file a bug report or wish at https://bugs.kde.org/

Where can I find the “original sources”?

All KDE Git repositories are available for browsing at https://invent.kde.org/.

For details on KDE's Git infrastructure see the dedicated GIT infrastructure page.