Difference between revisions of "Get Involved"

Jump to: navigation, search
(Streamline some of the text a bit, for improved readability)
(Update Konqi mascots)
(20 intermediate revisions by 6 users not shown)
Line 3: Line 3:
  
 
We want to make sure that the KDE Community remains a welcoming and friendly place where people can feel comfortable. We ask you to abide by the [https://www.kde.org/code-of-conduct/ KDE Community Code of Conduct] when interacting with the rest of the KDE Community.
 
We want to make sure that the KDE Community remains a welcoming and friendly place where people can feel comfortable. We ask you to abide by the [https://www.kde.org/code-of-conduct/ KDE Community Code of Conduct] when interacting with the rest of the KDE Community.
 
  
 
== Start Here! ==
 
== Start Here! ==
KDE wants to make it easy to get involved! The best way to contribute is to start at the top of this list and work your way down.
+
KDE wants to make it easy to get involved! Various KDE members are available to help new contributors; you can find them listed on the [[Mentoring]] page. Many of them hang out in the [https://matrix.to/#/#kde-welcome:matrix.org #kde-welcome Matrix room]. Feel free to ask them any questions you may have!
  
Begin by filing high-quality bugs. Then move on to triaging other people's bugs. Soon you'll start submitting patches for easy-to-fix issues you've discovered through bug triaging--including some of the bugs you filed earlier! Then move onto whatever speaks to you most--translation, visual design, promotion, accessibility; the sky's the limit!
+
Beyond that, the best way to contribute is to start at the top of this list and work your way down:
  
=== [[ Get Involved/Bug Reporting | Bug reporting]] [[File:Mascot konqi.png|x120px|right|]] ===
+
=== [[ Get Involved/Bug Reporting | Bug Reporting]] [[File:Mascot konqi.png|x120px|right|]] ===
 
If you've found a problem with a piece of KDE software, report it so the developers can fix it! QA is critically important to ensure quality, and you can be involved in an effort to make sure that our users are happy with the final products. [[ Get Involved/Bug Reporting | Find out more about bug reporting]].
 
If you've found a problem with a piece of KDE software, report it so the developers can fix it! QA is critically important to ensure quality, and you can be involved in an effort to make sure that our users are happy with the final products. [[ Get Involved/Bug Reporting | Find out more about bug reporting]].
  
 
===[[Guidelines and HOWTOs/Bug triaging|Bug Triaging]] [[File:Mascot konqi-support-bughunt.png|x120px|right|]]===
 
===[[Guidelines and HOWTOs/Bug triaging|Bug Triaging]] [[File:Mascot konqi-support-bughunt.png|x120px|right|]]===
If you'd like to take the next step in contributing to KDE, help triage all those bugs that people are filing! By separating the wheat from the chaff, you will help developers figure out what bugs they need to work on and help them get the information they need to fix them. You don't need any programming experience to triage bugs, and it's a perfect introduction if you want to eventually become a developer but don't feel like your programming experience is good enough yet. [[Guidelines and HOWTOs/Bug triaging|Find out more about helping squash bugs in KDE software]]
+
If you'd like to take the next step in contributing to KDE, help triage all those bugs that people are filing! By separating the wheat from the chaff, you will help developers figure out what bugs they need to work on and help them get the information they need to fix them. You don't need any programming experience to triage bugs, and it's a perfect introduction if you want to eventually become a developer but don't feel like your programming experience is good enough yet. [[Guidelines and HOWTOs/Bug triaging|Find out more about helping squash bugs in KDE software]].
  
===[[/development|Development]] [[File:Konqui dev close cropped.png|right|x120px|]]===
+
===[[/development|Development]] [[File:Mascot konqi-app-dev.png|right|x120px|]]===
 
By becoming a developer in the KDE community, you can affect millions by writing and improving world-class software used around the globe. There are many small jobs available, so you don't even need to be a programmer to start developing for KDE! In the process you'll learn portable, industry-standard skills like C++, Qt, and CMake, and collaborate with people from all around the world. It's a challenging and fun experience. [[/development|Find out more about becoming a KDE developer]].
 
By becoming a developer in the KDE community, you can affect millions by writing and improving world-class software used around the globe. There are many small jobs available, so you don't even need to be a programmer to start developing for KDE! In the process you'll learn portable, industry-standard skills like C++, Qt, and CMake, and collaborate with people from all around the world. It's a challenging and fun experience. [[/development|Find out more about becoming a KDE developer]].
 
   
 
   
===[[/translation|Translation]] [[File:Mascot_konqi-international.png|right|x120px|]]===
+
===[[/translation|Translation]] [[File:Mascot konqi-international.png|right|x120px|]]===
 
Are you fluent in multiple languages? By contributing your translations of the text in the user interfaces of KDE software, you can make it more pleasant for you to use, and open it up to millions of potential new users. [[/translation|Find out more about becoming a KDE translator]].
 
Are you fluent in multiple languages? By contributing your translations of the text in the user interfaces of KDE software, you can make it more pleasant for you to use, and open it up to millions of potential new users. [[/translation|Find out more about becoming a KDE translator]].
  
===[[/design|Visual and Human Interface Design]] [[File:Konqui artistic cropped.png|right|x120px|]]===
+
===[[/design|Visual and Human Interface Design]] [[File:Mascot konqi-app-graphics.png|right|x120px|]]===
 
Whether you are an artist, a designer, or just someone with an interest in how regular people interact with software, you are welcome to join the KDE Visual Design Group! The VDG makes KDE software both beautiful and usable by helping teams design and refine their user interfaces. This includes creating icons and themes, as well as thinking and researching how to help users do what they are trying to do. By joining this team, you can help make KDE's users happier and more productive. [[/design|Find out more about joining the VDG]].
 
Whether you are an artist, a designer, or just someone with an interest in how regular people interact with software, you are welcome to join the KDE Visual Design Group! The VDG makes KDE software both beautiful and usable by helping teams design and refine their user interfaces. This includes creating icons and themes, as well as thinking and researching how to help users do what they are trying to do. By joining this team, you can help make KDE's users happier and more productive. [[/design|Find out more about joining the VDG]].
 
   
 
   
Line 28: Line 27:
 
Even with the best-designed software, users will need documentation to help them do what they want and get the most out of it. The KDE Community values good-quality documentation, and those who write it. The work of this team has one of the biggest impacts on end-users. [[/documentation|Find out more about joining the KDE documentation team]].
 
Even with the best-designed software, users will need documentation to help them do what they want and get the most out of it. The KDE Community values good-quality documentation, and those who write it. The work of this team has one of the biggest impacts on end-users. [[/documentation|Find out more about joining the KDE documentation team]].
  
===[[/promotion|Promotion]] [[File:Konqui journalist cropped.png|right|x120px|]]===
+
===[[/promotion|Promotion]] [[File:Mascot konqi-commu-journalist.png|right|x120px|]]===
 
Do you know how to get the word out on the street? As part of the promo team, you'll help spread the word about KDE to people who don't know the amazing things we make. You'll be part of a great team of people who are moving the world! [[/promotion|Find out more about spreading the word about KDE]].
 
Do you know how to get the word out on the street? As part of the promo team, you'll help spread the word about KDE to people who don't know the amazing things we make. You'll be part of a great team of people who are moving the world! [[/promotion|Find out more about spreading the word about KDE]].
  
===[[/accessibility|Accessibility]] [[File:Mascot_konqi-app-system.png |x120px|right|]]===
+
===[[/accessibility|Accessibility]] [[File:Mascot konqi-app-system.png |x120px|right|]]===
 
Part of reaching as wide an audience as possible includes making KDE software easy to use for people with visual, auditory and motor disabilities. Whether you are familiar with the techniques and technologies involved in this or are just keen to help out, your help will be enthusiastically welcomed. [[/accessibility|Find out more about making KDE software more accessible]].
 
Part of reaching as wide an audience as possible includes making KDE software easy to use for people with visual, auditory and motor disabilities. Whether you are familiar with the techniques and technologies involved in this or are just keen to help out, your help will be enthusiastically welcomed. [[/accessibility|Find out more about making KDE software more accessible]].
  
 
===[https://www.kde.org/community/donations/index.php Donation] [[File:Mascot konqi-support-business.png |x120px|right|]]===
 
===[https://www.kde.org/community/donations/index.php Donation] [[File:Mascot konqi-support-business.png |x120px|right|]]===
KDE is a mostly volunteer community made up of people just like you! But not everything in this world is free--including web and file hosting costs, airfare to KDE events, and even hiring some full-time developers. If you would like to help KDE purchase the goods and services necessary to continue producing amazing free software, consider donating. [https://www.kde.org/community/donations/index.php Find out more about making a financial donation to KDE].
+
KDE is a mostly volunteer community made up of people just like you! But not everything in this world is free--including web and file hosting costs, airfare to KDE events, and even hiring some full-time employees. If you would like to help KDE purchase the goods and services necessary to continue producing amazing free software, consider donating. [https://www.kde.org/community/donations/index.php Find out more about making a financial donation to KDE].
  
 
===[[incubator | Add your project to KDE]]===
 
===[[incubator | Add your project to KDE]]===
Line 44: Line 43:
 
* [[Elisa]], a KDE music player
 
* [[Elisa]], a KDE music player
 
* [[Krita]], a KDE digital painting suite
 
* [[Krita]], a KDE digital painting suite
 +
* [[KDE Connect]], a tool to connect and integrate your mobile device
 +
 +
== Projects in need of extra love ==
 +
Here are some critically important projects that are in need of more development. The bugs and feature requests found on these pages are especially suitable for an experienced developer looking to make a big impact fast!
 +
* [[Dolphin]], a powerful and user-friendly file manager
 +
* [[Gwenview]], a robust image viewer
 +
* [[Okular]], a feature-filled document viewer
 +
* [[Spectacle]], a flexible screenshot tool
 +
* [[Baloo]], a file content and metadata indexer
 +
* [[Discover]], an App store and package updater
 +
* [[PIM]], a collection of personal information management applications
 +
* [[Breeze GTK theme]], which makes GTK applications look at home in Plasma
 +
* [[Kickoff]], a systemwide application launcher menu
 +
* [[KIO]], which provides I/O operations and the file dialogs
 +
* [[KWallet]], a password manager
  
  
 
==Getting in touch and working together==
 
==Getting in touch and working together==
Part of being in a community is talking to the other members. KDE members use a variety of different venues to communicate, depending on the topic.
+
Part of being in a community involves talking to the other members. Courtesy and politeness are expected. KDE members use a variety of different venues to communicate, depending on the topic.
 +
 
 +
* '''To report a bug or request a new feature''', use [https://bugs.kde.org/ bugs.kde.org]. The KDE Bugzilla bug tracker is intended for user-to-developer communication and tracks simple bug reports and feature requests. Sign in with your KDE Bugzilla account; it does not use identity.kde.org credentials. If you don't have a KDE Bugzilla account, [https://bugs.kde.org/createaccount.cgi sign up for one here]. More information about the KDE Bugzilla bug tracker is available [[Get Involved/Bug Reporting | here]].
  
* '''To track work''', such as offering a patch for review, updating a website, or coordinating a promotional campaign, KDE uses [[Infrastructure/Phabricator | Phabricator]]. Sign into Phabricator with the username and password for your identity.kde.org account; if you don't have one,  [https://identity.kde.org sign up for one here]. Then return to https://phabricator.kde.org, click the "Log In" button at the top of the page, and enter the username and password for your KDE Identity account. More information about Phabricator is available [[Infrastructure/Phabricator | here]].
+
* '''To track and discuss work''', use [[Infrastructure/Phabricator | Phabricator]] diffs and tasks. Phabricator is intended for developer-to-developer communication such as offering a patch for review, updating the contents of a website, discussing the implementation of a complex feature, or coordinating a promotional campaign. Sign into Phabricator with the username and password for your [https://identity.kde.org/ identity.kde.org] account; if you don't have one,  [https://identity.kde.org/index.php?r=registration/index sign up for one here]. Then return to https://phabricator.kde.org, click the "Log In" button at the top of the page, and enter the username and password for your KDE Identity account. More information about Phabricator is available [[Infrastructure/Phabricator | here]].
  
* '''To start a short, goal-driven discussion''', use [[Internet Relay Chat]] or [[Telegram]], depending on your preference.
+
* '''To start a short, goal-driven discussion''', use [[Internet Relay Chat]], [[Matrix]] or [[Telegram]], depending on your preference. These conversations should ideally result in the generation of a patch, task, or bug report.
  
 
* '''To start a long-term, open-ended discussion''', [https://www.kde.org/support/#mailinglists mailing lists] are best. You don't need to subscribe to them all; just a few will do. As a new member of the KDE Community, you should at least subscribe to [https://mail.kde.org/mailman/listinfo/kde-community kde-community] and [https://mail.kde.org/mailman/listinfo/kde-devel kde-devel]. You will need to subscribe before you can send mail to the lists.
 
* '''To start a long-term, open-ended discussion''', [https://www.kde.org/support/#mailinglists mailing lists] are best. You don't need to subscribe to them all; just a few will do. As a new member of the KDE Community, you should at least subscribe to [https://mail.kde.org/mailman/listinfo/kde-community kde-community] and [https://mail.kde.org/mailman/listinfo/kde-devel kde-devel]. You will need to subscribe before you can send mail to the lists.
  
The links in the [[#Ways to contribute]] section will take you to pages with more specific information, including how to get in touch with specific teams.
+
The links in the [[#Start_Here.21|#Start_Here!]] section will take you to pages with more specific information, including how to get in touch with specific teams.
  
==Mentoring==
+
==More entry points==
KDE has a variety of programmes to introduce new contributors to KDE. These include external programmes that we participate in like the [[GSoC|Google Summer of Code]] and the [[OutreachProgramForWomen|Outreach Program for Women]], as well as KDE's own programmes, such as [[SoK|Season of KDE]]. We also maintain an informal list of people who are willing to help out any newcomers. You can find an overview on the [[Mentoring]] page.
+
KDE participates in a variety of external programs to introduce new contributors to KDE, including the [[GSoC|Google Summer of Code]] and the [[OutreachProgramForWomen|Outreach Program for Women]]. KDE also runs its own programs, such as [[SoK|Season of KDE]].

Revision as of 10:48, 10 June 2019

Konqi and KDE dragons of different abilities!

Welcome to the KDE Community! By joining our team, you will be part of an international effort by thousands of people working to deliver a stunning Free Software computing experience. You will meet new friends, learn new skills and make a difference to millions of users while working with people from all around the globe. This page will give you a brief introduction to things everyone in KDE should know, and help you get started with contributing.

We want to make sure that the KDE Community remains a welcoming and friendly place where people can feel comfortable. We ask you to abide by the KDE Community Code of Conduct when interacting with the rest of the KDE Community.

Start Here!

KDE wants to make it easy to get involved! Various KDE members are available to help new contributors; you can find them listed on the Mentoring page. Many of them hang out in the #kde-welcome Matrix room. Feel free to ask them any questions you may have!

Beyond that, the best way to contribute is to start at the top of this list and work your way down:

Bug Reporting
Mascot konqi.png

If you've found a problem with a piece of KDE software, report it so the developers can fix it! QA is critically important to ensure quality, and you can be involved in an effort to make sure that our users are happy with the final products. Find out more about bug reporting.

Bug Triaging
Mascot konqi-support-bughunt.png

If you'd like to take the next step in contributing to KDE, help triage all those bugs that people are filing! By separating the wheat from the chaff, you will help developers figure out what bugs they need to work on and help them get the information they need to fix them. You don't need any programming experience to triage bugs, and it's a perfect introduction if you want to eventually become a developer but don't feel like your programming experience is good enough yet. Find out more about helping squash bugs in KDE software.

Development
Mascot konqi-app-dev.png

By becoming a developer in the KDE community, you can affect millions by writing and improving world-class software used around the globe. There are many small jobs available, so you don't even need to be a programmer to start developing for KDE! In the process you'll learn portable, industry-standard skills like C++, Qt, and CMake, and collaborate with people from all around the world. It's a challenging and fun experience. Find out more about becoming a KDE developer.

Translation
Mascot konqi-international.png

Are you fluent in multiple languages? By contributing your translations of the text in the user interfaces of KDE software, you can make it more pleasant for you to use, and open it up to millions of potential new users. Find out more about becoming a KDE translator.

Visual and Human Interface Design
Mascot konqi-app-graphics.png

Whether you are an artist, a designer, or just someone with an interest in how regular people interact with software, you are welcome to join the KDE Visual Design Group! The VDG makes KDE software both beautiful and usable by helping teams design and refine their user interfaces. This includes creating icons and themes, as well as thinking and researching how to help users do what they are trying to do. By joining this team, you can help make KDE's users happier and more productive. Find out more about joining the VDG.

Documentation
Mascot konqi-support-document.png

Even with the best-designed software, users will need documentation to help them do what they want and get the most out of it. The KDE Community values good-quality documentation, and those who write it. The work of this team has one of the biggest impacts on end-users. Find out more about joining the KDE documentation team.

Promotion
Mascot konqi-commu-journalist.png

Do you know how to get the word out on the street? As part of the promo team, you'll help spread the word about KDE to people who don't know the amazing things we make. You'll be part of a great team of people who are moving the world! Find out more about spreading the word about KDE.

Accessibility
Mascot konqi-app-system.png

Part of reaching as wide an audience as possible includes making KDE software easy to use for people with visual, auditory and motor disabilities. Whether you are familiar with the techniques and technologies involved in this or are just keen to help out, your help will be enthusiastically welcomed. Find out more about making KDE software more accessible.

Donation
Mascot konqi-support-business.png

KDE is a mostly volunteer community made up of people just like you! But not everything in this world is free--including web and file hosting costs, airfare to KDE events, and even hiring some full-time employees. If you would like to help KDE purchase the goods and services necessary to continue producing amazing free software, consider donating. Find out more about making a financial donation to KDE.

Add your project to KDE

If you have a project already that you want to bring into KDE, we have an incubation programme to help make that happen. Find out more about making your software a KDE project.

Beginner-friendly projects

Here are some beginner-friendly projects with a variety of opportunities to contribute:

  • Elisa, a KDE music player
  • Krita, a KDE digital painting suite
  • KDE Connect, a tool to connect and integrate your mobile device

Projects in need of extra love

Here are some critically important projects that are in need of more development. The bugs and feature requests found on these pages are especially suitable for an experienced developer looking to make a big impact fast!

  • Dolphin, a powerful and user-friendly file manager
  • Gwenview, a robust image viewer
  • Okular, a feature-filled document viewer
  • Spectacle, a flexible screenshot tool
  • Baloo, a file content and metadata indexer
  • Discover, an App store and package updater
  • PIM, a collection of personal information management applications
  • Breeze GTK theme, which makes GTK applications look at home in Plasma
  • Kickoff, a systemwide application launcher menu
  • KIO, which provides I/O operations and the file dialogs
  • KWallet, a password manager


Getting in touch and working together

Part of being in a community involves talking to the other members. Courtesy and politeness are expected. KDE members use a variety of different venues to communicate, depending on the topic.

  • To report a bug or request a new feature, use bugs.kde.org. The KDE Bugzilla bug tracker is intended for user-to-developer communication and tracks simple bug reports and feature requests. Sign in with your KDE Bugzilla account; it does not use identity.kde.org credentials. If you don't have a KDE Bugzilla account, sign up for one here. More information about the KDE Bugzilla bug tracker is available here.
  • To track and discuss work, use Phabricator diffs and tasks. Phabricator is intended for developer-to-developer communication such as offering a patch for review, updating the contents of a website, discussing the implementation of a complex feature, or coordinating a promotional campaign. Sign into Phabricator with the username and password for your identity.kde.org account; if you don't have one, sign up for one here. Then return to https://phabricator.kde.org, click the "Log In" button at the top of the page, and enter the username and password for your KDE Identity account. More information about Phabricator is available here.
  • To start a short, goal-driven discussion, use Internet Relay Chat, Matrix or Telegram, depending on your preference. These conversations should ideally result in the generation of a patch, task, or bug report.
  • To start a long-term, open-ended discussion, mailing lists are best. You don't need to subscribe to them all; just a few will do. As a new member of the KDE Community, you should at least subscribe to kde-community and kde-devel. You will need to subscribe before you can send mail to the lists.

The links in the #Start_Here! section will take you to pages with more specific information, including how to get in touch with specific teams.

More entry points

KDE participates in a variety of external programs to introduce new contributors to KDE, including the Google Summer of Code and the Outreach Program for Women. KDE also runs its own programs, such as Season of KDE.


Content is available under Creative Commons License SA 4.0 unless otherwise noted.