Qt-Contribution-Guidelines: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
 
(swap redirects)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=Qt Contribution Guidelines=
#REDIRECT [[Qt Contribution Guidelines]]
 
We have a community around the development of the Qt libraries, Qt related tools and add-ons. These guidelines will introduce you to the tools and mechanics as well as to the philosophies behind the development of Qt. You will learn how to set up your development environment for working on the library itself and how to submit code/documentation for inclusion.
 
[[Image:Qt_Contribution_Process.png]]
 
==Prerequisites==
 
First you have to get the Qt source code and set up your local working environment to build Qt. See [[Get The Source|Get the source]] ''[qt.io]'' for instructions.
 
==Style, Conventions and Principles==
 
For development of the Qt framework we follow the framework’s [[Qt Coding Style|Coding Style]] and we stick to our established [[Coding-Conventions|Coding Conventions]]. The [http://techbase.kde.org/Policies/Library_Code_Policy <span class="caps">KDE</span> Library Code Policy] ''[techbase.kde.org]'' is based on Qt’s, so much is shared with Qt’s. You can find more information there that isn’t in Qt pages.
 
Qt Creator uses its own [http://doc.qt.digia.com/qtcreator-extending/coding-style.html Qt Creator Specific Coding Style &amp; Conventions] ''[doc.qt.digia.com]''. It is similar to the Qt framework’s coding style and conventions, but there are some differences and additions.
 
In addition, conventions for writing good user interface messages texts that play well with Qt Linguist can be found under [[UI Text Conventions|UI_Text_Conventions]].
 
Our [[API-Design-Principles|<span class="caps">API</span> Design Principles]] aim for perfection.
 
Note that Qt is an open source library, and must therfore be compilable in its completeness using freely available tools and libraries. This means that you should not contribute code that uses any kind of private <span class="caps">API</span>s.
 
Please follow the [[Commit Policy]].
 
Verify that your commits have correct author information, including your name and email address as it is registered in gitorious.org.
 
==Localization to Other Languages==
 
The process of contributing translations is described in [[Qt-Localization|Qt Localization]].
 
==Making Changes to Qt==
 
The [[Git Introduction|Git_Introduction]] page describes a basic workflow of using Git to create changes, while the [[Gerrit Introduction|Gerrit_Tutorial]] in detail describes how our version of Gerrit works for the Qt Project.
 
Make sure it compiles with [[Qt In Namespace|Qt_In_Namespace]]
 
==Submitting your changes for inclusion into Qt==
 
There are some steps you need to follow only once:
 
# [http://bugreports.qt.io Create an account] ''[bugreports.qt.io]'' on the Qt Project bug tracker (Jira). This will be the same login information you will use in the [http://codereview.qt.io Gerrit code review system] ''[codereview.qt.io]''. Even though the account credentials are shared, you still need to complete the account details on the [http://codereview.qt.io Gerrit code review system] ''[codereview.qt.io]''. See the next step.
# Login on and set up [http://codereview.qt.io/#settings,contact your Gerrit account] ''[codereview.qt.io]'' by adding your full name, email address, and public <span class="caps">SSH</span> key.
# Review and agree to the Qt Project’s contribution agreement in Gerrit. You only need to do this once, unless the license changes. If your company has a corporate contribution agreement, ask the owner of the according Gerrit user group to add your account to this group.
# Clone Qt from Gitorious.
#* Qt 4: Add a git remote called “gerrit” in your cloned repository, which points to the Qt 4 project on <code>codereview.qt.io</code>.
#* Qt 5: When you run the init-repository script, provide your Gerrit username to the —codereview-user option.
 
Then there are steps you need to follow for each patch you contribute:
 
# Push you changes to remote “gerrit” to the branch <code>refs/for/master</code>, if <code>master</code> is the branch you are targeting.
# The [[Early-Warning-System|Early Warning System]] (<span class="caps">EWS</span>) will quickly kick in and check your patch. Please act upon the reports and push updates to the patch.
# '''Add relevant reviewers to your change(s).''' If you don’t do this, your change may go unnoticed. To find possible reviewers, you can:
#* examine the Git history with ‘git log’ and/or ‘git blame’,
#* see the [[Maintainers|Maintainer chart]],
#* ask on <span class="caps">IRC</span>, or
#* ask on relevant mailing lists like development@qt.io or qt-creator@qt.io etc.
# Wait for reviews, and actively partake in the review of your change(s).
#* If your contribution is deemed to not align with the project’s vision or goals, you should [[Gerrit-Tutorial|abandon the change]] at this point.
#* If your contribution is deemed unready, you need to fix it up according to the reviews.
# Submit your patch. If your contribution satisfies the technical requirements, then you or the Approver are able to submit the patch into the staging branch, or directly into the target branch, if there’s no CI system on that particular branch and/or repository.
#* To determine if the branch is covered by the CI system, you may check [http://testresults.qt.io/ci/ the CI logs] ''[testresults.qt.io]'' ; if the project/branch can be found at this link, it is covered by CI.
#* If the [[Public Autotest Infrastructure|continuous integration (CI)]] system rejects your patch, you need to fix the issues so it passes the project’s build and autotest systems.
# When CI is successful, your changes are automatically included and added to the official Qt repository.
 
==Developer’s Lounge==
 
If you have any questions about the development of Qt, feel free to join the <code>#qt-labs</code> <span class="caps">IRC</span> channel on <code>irc.freenode.net</code> and the [http://lists.qt.io/mailman/listinfo/development Qt development mailing list] ''[lists.qt.io]'' Qt Creator development, join <code>#qt-creator on irc.freenode.net</code> and the [http://lists.qt.io/mailman/listinfo/qt-creator Qt Creator mailing list] ''[lists.qt.io]''.
 
For a full list of <span class="caps">IRC</span> channels of interest to Qt developers, see [[OnlineCommunities|http://wiki.qt.io/OnlineCommunities]] .
 
===Categories:===
 
* [[:Category:Developing Qt|Developing_Qt]]
** [[:Category:Developing Qt::Guidelines|Guidelines]]

Latest revision as of 11:06, 27 February 2015