GoogleCodeIn/LandingPageforKDE: Difference between revisions
(moved all IRC sections together, fixed some bko bits) |
|||
Line 19: | Line 19: | ||
More about [https://www.kde.org/applications/internet/konversation Konversation], and [https://userbase.kde.org/Konversation Konversation user manual]. | More about [https://www.kde.org/applications/internet/konversation Konversation], and [https://userbase.kde.org/Konversation Konversation user manual]. | ||
=IRC | = IRC channels for task categories = | ||
Tasks in Google Code-in are grouped into five categories. Below are the recommended channels for each category | Tasks in Google Code-in are grouped into five categories. Below are the recommended channels for each category which could be helpful to you as you work on a task. '''''#kde-soc''''' is the channel for all mentors and students. Your mentor may ask you to join a project channel so that the whole team is available to you. | ||
* Code: ''#kde-devel'' | * Code: ''#kde-devel'' | ||
* Documentation/Training: ''#kde-docs'' | * Documentation/Training: ''#kde-docs'' and ''#kde-www'' | ||
* Outreach/Research: ''#kde'' and ''#kde-promo'' | * Outreach/Research: ''#kde'' and ''#kde-promo'' | ||
* Quality Assurance: ''#kde-bugs'' and ''#kde-quality'' | * Quality Assurance: ''#kde-bugs'' and ''#kde-quality'' | ||
* User Interface: ''#kde-usability'' | * User Interface: ''#kde-usability'' | ||
= Best practices in Google Code-in conversations = | |||
= Best practices in | |||
KDE uses IRC and mailing lists to communicate. While talking with your mentors, community members and other students remember: | KDE uses IRC and mailing lists to communicate. While talking with your mentors, community members and other students remember: | ||
Line 64: | Line 45: | ||
* Don’t attach files unless your mentor has specifically told you to do so. | * Don’t attach files unless your mentor has specifically told you to do so. | ||
* Plain text please, unless you are asked to include graphics, charts, or other images. | * Plain text please, unless you are asked to include graphics, charts, or other images. | ||
= KDE identity = | |||
To commit code, edit wikis and other tasks, create a KDE Identity. KDE Identity is the central database for KDE infrastructure. Using your KDE Identity credentials, you can log into all Identity-enabled KDE services. Please use your real name to [https://identity.kde.org/index.php?r=registration register for a KDE identity account]. | |||
= KDE wikis = | |||
Wikis are easy to update, so much information is stored on the KDE wikis. | |||
* [https://wiki.kde.org/ Main page for KDE wikis] | |||
* [https://userbase.kde.org/Welcome_to_KDE_UserBase KDE User information] | |||
* [https://techbase.kde.org/Welcome_to_KDE_TechBase KDE Technical information] | |||
* [https://community.kde.org/Main_Page KDE Community Wiki] | |||
= Bugzilla = | |||
KDE uses Bugzilla to deal with bugs. Create a Bugzilla account to report, test, triage, or fix bugs. For now, a bugzilla account is needed in addition to your KDE identity account. | |||
[http://bugs.kde.org/ Bugs.kde.org aka bko] | |||
= Google Code-in best practices = | = Google Code-in best practices = |
Revision as of 09:27, 12 December 2014
The KDE Community
The KDE Community is an international team co-operating on development and distribution of Free, Open Source Software for desktop and portable computing. Our community has developed a wide variety of applications for communication, work, education and entertainment. We have a strong focus on finding innovative solutions to old and new problems, creating a vibrant, open atmosphere for experimentation. Since our software is free and open source, everyone can play a part in contributing to KDE.
Software produced by KDE
For users on Linux and Unix, KDE offers a full suite of user workspace applications which allow interaction with these operating systems in a modern, graphical user interface. This includes Plasma Desktop, KDE's innovative desktop interface. Other workspace applications are included to aid with system configuration, running programs, or interacting with hardware devices. While the fully integrated KDE Workspaces are only available on Linux and Unix, some of these features and our applications are available on other platforms.
How to connect with mentors via IRC
Mentors are the main people you communicate with while completing a task. They are the people whom you ask when you have any questions to ask regarding the task. Along with leaving messages in melange, you can communicate with them via IRC, a chat system. You can use webchat.freenode.net in your browser, and may want to consider using a desktop IRC client if you enjoy IRC. KDE uses the Freenode network along with many other open-source projects. To chat in IRC just type and hit [enter]. Commands begin with the "/" character, such as /connect irc.freenode.net to connect to Freenode if you've not already done so.
IRC is made of channels (think, "chat rooms") which start with a pound sign, such as "#kde". On Freenode, you can expect to find a channel for almost any FOSS project, eg, #Fedora, #Python, #Ubuntu. To join a channel, use the /join command, eg, /join #kde or /join #kde-soc .
IRC Clients
IRC clients communicate with IRC network servers to allow sending of messages from one user to another. You may have to install an IRC client if your distribution doesn't provide one. Some examples of IRC clients are XChat and IRSSI for Linux or Windows, and Colloquy for Mac. KDE's IRC client is Konversation which will connect you to Freenode by default.
More about Konversation, and Konversation user manual.
IRC channels for task categories
Tasks in Google Code-in are grouped into five categories. Below are the recommended channels for each category which could be helpful to you as you work on a task. #kde-soc is the channel for all mentors and students. Your mentor may ask you to join a project channel so that the whole team is available to you.
- Code: #kde-devel
- Documentation/Training: #kde-docs and #kde-www
- Outreach/Research: #kde and #kde-promo
- Quality Assurance: #kde-bugs and #kde-quality
- User Interface: #kde-usability
Best practices in Google Code-in conversations
KDE uses IRC and mailing lists to communicate. While talking with your mentors, community members and other students remember:
IRC
- Be considerate and polite.
- Never put your personal information (phone number, home address) on a mailing list or in IRC .
- During Google Code-in mentors are sometimes busy helping students, or reviewing tasks. They may not see you join, or see what you write for several minutes. However, especially for beginner tasks, other students and mentors are usually happy to help.
Mail lists
- When responding to an existing post, please quote relevant text from the original message. It should be easy for those who did not read the original message to understand the issue.
- Keep subject lines to the point and your message concise.
- Don’t attach files unless your mentor has specifically told you to do so.
- Plain text please, unless you are asked to include graphics, charts, or other images.
KDE identity
To commit code, edit wikis and other tasks, create a KDE Identity. KDE Identity is the central database for KDE infrastructure. Using your KDE Identity credentials, you can log into all Identity-enabled KDE services. Please use your real name to register for a KDE identity account.
KDE wikis
Wikis are easy to update, so much information is stored on the KDE wikis.
Bugzilla
KDE uses Bugzilla to deal with bugs. Create a Bugzilla account to report, test, triage, or fix bugs. For now, a bugzilla account is needed in addition to your KDE identity account.
Google Code-in best practices
- You may get help from the community to complete your task.
- Getting to know some KDE people and learning KDE processes and requirements are part of GCi.
- Ask for help if you're stuck, but remember that you should try to solve the problem yourself before getting assistance.
- You have taken responsibility for accomplishing your task, so it's perfectly acceptable to get it done in a collaborative fashion - that's how open source works!
- Remember that you are not allowed to copy anyone else's work and pretend it is your own.