|
|
Ready to start contributing changes to Plasma Mobile? This page guides you on the process.
|
|
|
|
|
|
We assume Git knowledge, as well as some terminology (ex. merge/pull request).
|
|
|
|
|
|
### Creating a KDE Identity Account
|
|
|
|
|
|
In order to have an account on our [GitLab instance](https://invent.kde.org), you need to have a KDE Identity account.
|
|
|
|
|
|
You may register [here](https://identity.kde.org/index.php?r=registration). Note that we will need you to provide a name and email address, which will be **publicly visible on GitLab**.
|
|
|
|
|
|
Once you have confirmed your email, you should now be able to login to [KDE Invent](https://invent.kde.org). You can now create issues, fork repositories and contribute merge requests!
|
|
|
|
|
|
### Conventions
|
|
|
|
|
|
In order to contribute to a repository, **fork** the respective repository to your account. From there, you can create a branch and start work on your changes.
|
|
|
|
|
|
By convention, developers typically name their work branch in the format `work/user/[change]` (ex. `work/devinlin/add-font-bold`). This allows distinguishing from other branches, such as release branches on Plasma repositories (ex. `Plasma/5.24`).
|
|
|
|
|
|
To **submit** the patch, create a merge request on the upstream repository, and let contributors know about the change in the [development channel](https://matrix.to/#/#plasmamobile:matrix.org).
|
|
|
|
|
|
If a developer asks you to **cherry-pick** your commits to a release branch, this means that they want you to "backport" your change so that it would be released as part of a patch/fix release in the future. This should only be done for bugfixes, not new features!
|
|
|
|
|
|
Please also read the [KDE commit policy](https://community.kde.org/Policies/Commit_Policy) before submitting patches.
|
|
|
|
|
|
### KDE Developer Accounts
|
|
|
|
|
|
Having a KDE Developer Account allows you to *push directly* to KDE repositories, without needing to fork the repository.
|
|
|
|
|
|
Once a contributor has done some work, they will be encouraged by existing developers to apply for a KDE Developer account.
|
|
|
|
|
|
For detailed information about KDE Developer accounts, you can [read this page](https://community.kde.org/Infrastructure/Get_a_Developer_Account).
|
|
|
|
|
|
---
|
|
|
|
|
|
<img src="uploads/a2cbd828e88eadc8d2ce14c387bc14ba/image.png" width=200px/> |
|
|
\ No newline at end of file |