This guide explains how to create an account, set up a fork and local repository and contribute to Kaidan.
It is targeted at people who want to start contributing to Kaidan quickly.
Knowledge of KDE Identity, GitLab or Git is not needed.
Click on Fork to create a connected copy of Kaidan's main repository.
That fork is your own remote repository where you will upload (in Git terminology called push) a new recorded state (called commit) of your local repository after changing it.
The address of your remote repository will be https://invent.kde.org//kaidan.git where is your KDE Identity account username (e.g. https://invent.kde.org/alice/kaidan.git for the username alice).
That username is also used as your username for contributing.
git remote add alice https://invent.kde.org/alice/kaidan.git
Set the default remote repository for pushing commits:
git config remote.pushDefault <username>
git config remote.pushDefault alice
Fetch the most up-to-date versions of all remote repositories (those are currently the main remote repository https://invent.kde.org/kde/kaidan.git and your own forked remote repository https://invent.kde.org/<username>/kaidan.git):
git fetch --all
Create a branch from Kaidan's main development branch master and switch to it for modifying files:
git checkout -b <branch-name> master
git checkout -b feature/message-search master
Modify the files related to your commit and save them.
Mark (called stage) the current state of the modified files for storing as a commit:
git add <files>
git add CMakeLists.txt README.md
Create a commit containing the staged state of the modified files with a short commit message starting with an a upper case letter and using the present tense and imperative:
git commit -m"<commit message>"
git commit -m"Add dependencies for notifications"
Push the commit to your own remote repository:
Open a merge request (MR) for submitting your changes to Kaidan's main repository:
Go to the overview of your branches on your remote repository https://invent.kde.org/<username>/kaidan/-/branches (Example: https://invent.kde.org/alice/kaidan/-/branches).
Click on Merge request in the row of your branch containing the commit you want to submit (Example: row of feature/message-search).
Select Delete source branch when merge request is accepted. so that the branch on your remote repository will be deleted when your MR is accepted.
Select Allow commits from members who can merge to the target branch. so that the maintainers of Kaidan's main repository can apply necessary changes before merging your branch into the master branch.