Get Involved/Quality: Difference between revisions

From KDE Community Wiki
m (A couple of http-to-https upgrades.)
(44 intermediate revisions by 7 users not shown)
Line 1: Line 1:
[Category:Testing]
[[Category:Testing]]


== Becoming a KDE Tester ==
[[Image:testing.png|Quality|left]]In the early 2000's there was a specific team at KDE which was focused on finding loose ends in KDE applications and tying them together. This was a task of user case studies, writing articles, documentation, creating missing artwork for consistency, and other miscellanea. Ultimately, this team contributed patches of code and documentation that really rounded out the KDE experience.


[[Image:testing.png|Testing|left]]In the early 2000's there was a specific team at KDE which was focused on finding loose ends in KDE applications and tying them together. This was a task of user case studies, writing articles, documentation, creating missing artwork for consistency, and other miscellanea. Ultimately, this team contributed patches of code and documentation that really rounded out the KDE experience.
Early 2012 this team was revived and now has a [https://mail.kde.org/mailman/listinfo/kde-testing mailing list] as well as a channel called #kde-quality on irc.freenode.net.


== Communicating with the team ==
There are many different domains a Quality team should cover (see a complete list here:  *http://techbase.kde.org/Contribute/Quality_Team), but as a newly starting team we decided to focus our work on testing, mainly also because of the reduced manpower we started with.


Early 2012 this team was revived and now has a [https://mail.kde.org/mailman/listinfo/kde-testing mailing list] as well as a channel called #kde-quality on irc.freenode.net.
= Testing =


== What exactly does testing mean? ==
== What exactly does testing mean? ==


Testing is part of the overall Quality Assurance of software. More information about the exact definition can be found here: http://en.wikipedia.org/wiki/Software_quality_assurance and here: http://en.wikipedia.org/wiki/Software_testing
Testing is part of the overall Quality Assurance of software. More information about the exact definition can be found here: http://en.wikipedia.org/wiki/Software_quality_assurance and here: http://en.wikipedia.org/wiki/Software_testing
A very interesting read is this: http://www.thebraidytester.com/downloads/YouAreNotDoneYet.pdf
Please also have a look at the [http://community.kde.org/Getinvolved/Quality/Tutorial Tutorial on how to become a KDE Tester]


== Initial steps ==
== Initial steps ==


Since this is a new start we need to define the exact goal of this team. There is a [http://community.kde.org/Getinvolved/testing/Brainstorming Brainstorming] page where ideas are gathered.
Since this is a new start we need to define the exact goal of this team. There is a [http://community.kde.org/Getinvolved/Quality/Brainstorming Brainstorming] page where ideas are gathered.


=== Wiki work ===
=== Wiki work ===


The basics is of course to establish a useful wiki resource. We currently use https://trello.com/kdetesting to avoid duplicate work. Please ping Anne-Marie (annma) or Myriam (Mamarok) in #kde-quality on irc.freenode.net to be added to the group.
The basics is of course to establish a useful wiki resource. We currently use https://trello.com/kdetesting to avoid duplicate work. Please ping Anne-Marie (annma) or Myriam (Mamarok) in #kde-quality on irc.freenode.net to be added to the group.
=== Trunk testing ===
Trunk testing can be done with packages as well as building from source: [[Plasma/InstallingNext]]
=== Beta testing ===
Please see [http://community.kde.org/Getinvolved/Testing/Beta/ the Beta subpage] for more information.


== Existing testing infrastructure ==
== Existing testing infrastructure ==
Line 26: Line 38:


KDE already runs a build server with [http://community.kde.org/Sysadmin/Jenkins Jenkins]: http://build.kde.org/ Please ask the KDE sysadmins if you would like to use it for your project.
KDE already runs a build server with [http://community.kde.org/Sysadmin/Jenkins Jenkins]: http://build.kde.org/ Please ask the KDE sysadmins if you would like to use it for your project.
Who gets the results? Who fixes them? This tool needs to be really used.


=== Unit tests ===
=== Unit tests ===
Tutorial for unit tests in KDE: http://techbase.kde.org/Development/Tutorials/Unittests


=== UI tests ===
Tutorial for unit tests in KDE: https://community.kde.org/Guidelines_and_HOWTOs/UnitTests
We will need to evaluate what tool would be the best for KDE. A list can be found here: http://en.wikipedia.org/wiki/List_of_GUI_testing_tools (incomplete) and here: http://www.opensourcetesting.org


=== Code (syntax) tests ===
=== Code (syntax) tests ===
Line 39: Line 50:
Another static code analyzer is [http://sourceforge.net/apps/mediawiki/cppcheck/index.php?title=Main_Page cppcheck] which can be integrated with Jenkins.
Another static code analyzer is [http://sourceforge.net/apps/mediawiki/cppcheck/index.php?title=Main_Page cppcheck] which can be integrated with Jenkins.


== Existing testing tools ==
The [http://clang-analyzer.llvm.org/ Clang Static Analyzer] is also a useful tool and can be integrated with Jenkins.
 
More information can also be found here: http://techbase.kde.org/Development/Tutorials/Code_Checking
 
Coverity Prevent is another tool, not Open Source but we can get the results from it.
 
Currently KDE is also subscribed to http://scan.coverity.com/, all developers can get an account on  it, the project admins just have to approve them.
 
Other available tools:


An non-exhaustive and maybe not up-to-date list of testing tools can be found here: http://www.opensourcetesting.org/
*[http://www.parasoft.com/static-analysis Prevent] by Parasoft
See also http://techbase.kde.org/Development/Tools#Quality_Assurance
*[http://www.klocwork.com/products/insight/source-code-analysis/ Klocwork]


=== QtTest ===
=== Debugging ===


Qt provides a testing module that can be used for unit testing: http://qt-project.org/doc/qt-4.8/qttest.html There also is a possibility to do basic UI testing.
KDE already has an extensive wiki for debugging: http://techbase.kde.org/Development/Tutorials/Debugging


=== Valgrind ===
== Existing testing tools ==


A tool to analyze memory leaks: http://techbase.kde.org/Development/Tools/Valgrind
An non-exhaustive and maybe not up-to-date list of testing tools can be found here: http://www.opensourcetesting.org/
See also http://techbase.kde.org/Development/Tools#Quality_Assurance


=== Piglit ===
{| class="wikitable" style="text-align: center;
! Name
! Description
|-
| QtTest
| Qt provides a testing module that can be used for unit testing: https://doc.qt.io/qt-5/qttest-index.html There also is a possibility to do basic UI testing.
|-
| Valgrind
| A tool to analyze memory leaks: http://techbase.kde.org/Development/Tools/Valgrind All apps should be ran through Valgrind on a regular basis, part of the Quality Assurance.
|-
| Piglit
| A tool to test OpenGL drivers: https://people.freedesktop.org/~nh/piglit/ might be useful to test parts of KWin and other OpenGL applications.
|-
| Gamma Ray
| A dynamic code analyzer: http://www.kdab.com/kdab-products/gammaray/ It is more a tool for developers to help them track down problems than a QA tool.
|-
| Testopia
| Testopia provides a test case management together with Bugzilla. This is currently evaluated by the KDE sysadmins: http://www.mozilla.org/projects/testopia/ please be patient
|-
| Squish
| Not Open Source software, but there is a free KDE version. Email [email protected] and say what you're doing to get it. Note that the KDE version isn't mentioned on the website. There is generic information: https://www.froglogic.com/
|-
| UI tests
| We will need to evaluate what tool would be the best for KDE. A list can be found here: https://en.wikipedia.org/wiki/List_of_GUI_testing_tools (incomplete) and here: http://www.opensourcetesting.org
|}


A tool to test OpenGL drivers: http://people.freedesktop.org/~nh/piglit/ might be useful to test parts of KWin and other OpenGL applications.
== ATP Examples ==


=== Gamma Ray ===
The following are examples for application testing procedures:


A dynamic code analyzer: http://www.kdab.com/kdab-products/gammaray/
[http://websvn.kde.org/trunk/KDE/kdesdk/umbrello/test/ATP.txt?revision=1244714&view=markup Application Test Procedure for Umbrello]


=== Testopia ===


Testopia provides a test case management together with Bugzilla. This is currently evaluated by the KDE sysadmins: http://www.mozilla.org/projects/testopia/ please be patient
== Quality Guidelines ==


== Trunk testing ==
Plasma Applets: http://community.kde.org/Getinvolved/Testing/Plasma_Applet_Quality_Guidelines


Trunk testing can be done with Project Neon: http://techbase.kde.org/Getting_Started/Using_Project_Neon_to_contribute_to_KDE
= Bug handling =


== Beta testing ==
== Bug triaging ==


An essential part in the testing process is to have a cleaned up bugzilla database in terns of actuality of the bugs. For more information about bug triaging and participating in the KDE Bugsquad please see also the [https://community.kde.org/Bugsquad KDE Bugsquad wiki]


== The Extra Mile ==


== Links ==
There also is an initiative that aims to help KDE applications and workspaces to identify and fix small bugs and UI issues which get in the way of the user:


*http://techbase.kde.org/Contribute/Quality_Team needs to be updated
* [http://community.kde.org/Getinvolved/Extra_Mile Extra Mile Initiative]

Revision as of 08:53, 26 October 2019


Quality
Quality

In the early 2000's there was a specific team at KDE which was focused on finding loose ends in KDE applications and tying them together. This was a task of user case studies, writing articles, documentation, creating missing artwork for consistency, and other miscellanea. Ultimately, this team contributed patches of code and documentation that really rounded out the KDE experience.

Early 2012 this team was revived and now has a mailing list as well as a channel called #kde-quality on irc.freenode.net.

There are many different domains a Quality team should cover (see a complete list here: *http://techbase.kde.org/Contribute/Quality_Team), but as a newly starting team we decided to focus our work on testing, mainly also because of the reduced manpower we started with.

Testing

What exactly does testing mean?

Testing is part of the overall Quality Assurance of software. More information about the exact definition can be found here: http://en.wikipedia.org/wiki/Software_quality_assurance and here: http://en.wikipedia.org/wiki/Software_testing

A very interesting read is this: http://www.thebraidytester.com/downloads/YouAreNotDoneYet.pdf

Please also have a look at the Tutorial on how to become a KDE Tester

Initial steps

Since this is a new start we need to define the exact goal of this team. There is a Brainstorming page where ideas are gathered.

Wiki work

The basics is of course to establish a useful wiki resource. We currently use https://trello.com/kdetesting to avoid duplicate work. Please ping Anne-Marie (annma) or Myriam (Mamarok) in #kde-quality on irc.freenode.net to be added to the group.

Trunk testing

Trunk testing can be done with packages as well as building from source: Plasma/InstallingNext

Beta testing

Please see the Beta subpage for more information.

Existing testing infrastructure

Continuous Integration (Jenkins)

KDE already runs a build server with Jenkins: http://build.kde.org/ Please ask the KDE sysadmins if you would like to use it for your project. Who gets the results? Who fixes them? This tool needs to be really used.

Unit tests

Tutorial for unit tests in KDE: https://community.kde.org/Guidelines_and_HOWTOs/UnitTests

Code (syntax) tests

A static code analyzing tool is provided by the EnglishBreakfastNetwork.

Another static code analyzer is cppcheck which can be integrated with Jenkins.

The Clang Static Analyzer is also a useful tool and can be integrated with Jenkins.

More information can also be found here: http://techbase.kde.org/Development/Tutorials/Code_Checking

Coverity Prevent is another tool, not Open Source but we can get the results from it.

Currently KDE is also subscribed to http://scan.coverity.com/, all developers can get an account on it, the project admins just have to approve them.

Other available tools:

Debugging

KDE already has an extensive wiki for debugging: http://techbase.kde.org/Development/Tutorials/Debugging

Existing testing tools

An non-exhaustive and maybe not up-to-date list of testing tools can be found here: http://www.opensourcetesting.org/ See also http://techbase.kde.org/Development/Tools#Quality_Assurance

Name Description
QtTest Qt provides a testing module that can be used for unit testing: https://doc.qt.io/qt-5/qttest-index.html There also is a possibility to do basic UI testing.
Valgrind A tool to analyze memory leaks: http://techbase.kde.org/Development/Tools/Valgrind All apps should be ran through Valgrind on a regular basis, part of the Quality Assurance.
Piglit A tool to test OpenGL drivers: https://people.freedesktop.org/~nh/piglit/ might be useful to test parts of KWin and other OpenGL applications.
Gamma Ray A dynamic code analyzer: http://www.kdab.com/kdab-products/gammaray/ It is more a tool for developers to help them track down problems than a QA tool.
Testopia Testopia provides a test case management together with Bugzilla. This is currently evaluated by the KDE sysadmins: http://www.mozilla.org/projects/testopia/ please be patient
Squish Not Open Source software, but there is a free KDE version. Email [email protected] and say what you're doing to get it. Note that the KDE version isn't mentioned on the website. There is generic information: https://www.froglogic.com/
UI tests We will need to evaluate what tool would be the best for KDE. A list can be found here: https://en.wikipedia.org/wiki/List_of_GUI_testing_tools (incomplete) and here: http://www.opensourcetesting.org

ATP Examples

The following are examples for application testing procedures:

Application Test Procedure for Umbrello


Quality Guidelines

Plasma Applets: http://community.kde.org/Getinvolved/Testing/Plasma_Applet_Quality_Guidelines

Bug handling

Bug triaging

An essential part in the testing process is to have a cleaned up bugzilla database in terns of actuality of the bugs. For more information about bug triaging and participating in the KDE Bugsquad please see also the KDE Bugsquad wiki

The Extra Mile

There also is an initiative that aims to help KDE applications and workspaces to identify and fix small bugs and UI issues which get in the way of the user: