KTp/Getting Involved: Difference between revisions

From KDE Community Wiki
< KTp
(Added "The Architecture of Open Source Applications: Telepathy" to Recommended Reading)
(Update page content (somewhat) and make transcludable for insertion on the main KTp page)
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{:KTp/Header}}
<noinclude>{{:KTp/Header}}</noinclude>


==Who can be a contributor?==
=== Who can be a contributor? ===
This project needs coders, designers, artists, testers, documentation writers. To help out, get in touch, tell us how you're interested in helping.


This project needs people from all skillsets; coders, designers, artists, testers, documentation writers.
=== Contacting the developers ===
==== IRC ====
* The [https://web.libera.chat/#ircs://irc.libera.chat:+6697/#kde-telepathy '''#kde-telepathy''' IRC channel] on Libera.Chat (web client)


For most the above, get in touch, tell us what you're interested in helping with.
==== Email ====
* The [https://mail.kde.org/mailman/listinfo/kde-telepathy KDE Telepathy mailing list]


If you're interested in contributing programming, read on!
=== Setup ===
:'''''Main page:''''' [[KTp/Getting Set Up|Instructions]]


==Contacting Us==
Before you start playing with/hacking on the Telepathy integration stuff, you need to have the latest version compiled and working.
===IRC===
<nowiki>
#kde-telepathy channel on irc.freenode.net
</nowiki>


===Email===
=== First steps ===
[https://mail.kde.org/mailman/listinfo/kde-telepathy mailing list].
The best way to get involved is to start working on some "junior jobs". These are small bugs or features that exist in our applications that are a good way to get to learn the code, and learn our workflow process.


A list of junior jobs can be found [https://bugs.kde.org/buglist.cgi?bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=ASSIGNED&bug_status=REOPENED&keywords=junior-jobs&keywords_type=allwords&order=Last%20Changed&product=telepathy here].


==Setting Up==
If you want to work on any of those, get in touch!
Before you start playing with/hacking on the Telepathy integration stuff, you need to have the latest version compiling and working: [[KTp/Getting_Set_Up|Instructions]]
 
==First Steps==
The best way to get involved is to start on some "junior jobs". These are small bugs or features that exist in our applications that are a good way to get to learn the code, and learn our workflow process
 
A list of junior jobs can be found [https://bugs.kde.org/buglist.cgi?keywords=junior-jobs&query_format=advanced&keywords_type=allwords&list_id=740250&bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=ASSIGNED&bug_status=REOPENED&product=telepathy here].


If you want to work on any of those, get in touch!
=== Recommended Reading ===
* [https://telepathy.freedesktop.org/wiki/ Telepathy Wiki]
* [https://telepathy.freedesktop.org/spec/index.html Telepathy Specifications]
* [https://telepathy.freedesktop.org/doc/telepathy-qt/ Telepathy Qt Documentation]
* [https://aosabook.org/en/v1/telepathy.html The Architecture of Open Source Applications: Telepathy]
* [https://api.kde.org/ KDE API documentation]
* [https://docs.github.com/en/get-started/getting-started-with-git GitHub Docs: Getting Started with Git]


==Recommended Reading==
=== Workflow ===
* [http://telepathy.freedesktop.org/wiki/ Telepathy Wiki]
If you want to work on a feature, start by cloning the git repository from the KDE Invent server. Then create a new branch in the cloned directory and start working there. Try to keep your commits atomic (small and meaningful). Once you are finished working on a single bug or feature, push the branch in your cloned repository back to the KDE Invent server (under your own account) and then use the [https://invent.kde.org/ web interface] to create a Merge Request back to the official repository before asking someone on the developer team to review it. Once it is reviewed, you may be asked to make further changes, but once all concerns are addressed it will be merged into the codebase.
* [http://telepathy.freedesktop.org/spec/index.html Telepathy Specs]
* [http://telepathy.freedesktop.org/doc/telepathy-qt/ Telepathy Qt Documentation]
* [http://www.aosabook.org/en/telepathy.html The Architecture of Open Source Applications: Telepathy]
* [http://api.kde.org/ KDE API documentation]
* [http://try.github.io/ Learn Git]


==Workflow==
=== External links ===
If you want to work on a feature, clone the git repository on the server side and then clone your personal clone on your local machine. Make a new git branch and start working there. Try to keep commits small and meaningful. Once you are finished, push the branch on your server-side clone and ask someone of the team to review it. Once it is reviewed, you can merge it on the master repository (or ask someone else to merge it).
* [https://telepathy.freedesktop.org Telepathy home page] (FreeDesktop.org)

Latest revision as of 07:48, 26 February 2024

Project logo Welcome to the
KDE Telepathy Development Wiki
Current Version: 23.07.70

Open Hub project report for KDE Telepathy

Who can be a contributor?

This project needs coders, designers, artists, testers, documentation writers. To help out, get in touch, tell us how you're interested in helping.

Contacting the developers

IRC

Email

Setup

Main page: Instructions

Before you start playing with/hacking on the Telepathy integration stuff, you need to have the latest version compiled and working.

First steps

The best way to get involved is to start working on some "junior jobs". These are small bugs or features that exist in our applications that are a good way to get to learn the code, and learn our workflow process.

A list of junior jobs can be found here.

If you want to work on any of those, get in touch!

Recommended Reading

Workflow

If you want to work on a feature, start by cloning the git repository from the KDE Invent server. Then create a new branch in the cloned directory and start working there. Try to keep your commits atomic (small and meaningful). Once you are finished working on a single bug or feature, push the branch in your cloned repository back to the KDE Invent server (under your own account) and then use the web interface to create a Merge Request back to the official repository before asking someone on the developer team to review it. Once it is reviewed, you may be asked to make further changes, but once all concerns are addressed it will be merged into the codebase.

External links