Editing Maemo contribution guidelines

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
 +
'''DRAFT'''
 +
These are the guidelines third party developers need to observe when contributing code to open source software maintained or distributed by Nokia in the Maemo platform:
These are the guidelines third party developers need to observe when contributing code to open source software maintained or distributed by Nokia in the Maemo platform:
-
== Contributions welcome! ==
+
=== Contributions welcome! ===
-
 
+
The Maemo SW team at Nokia encourages revision and feedback of the open source components of the Maemo platform and related open source applications.
The Maemo SW team at Nokia encourages revision and feedback of the open source components of the Maemo platform and related open source applications.
-
== Sources ==
+
=== Sources ===
 +
The sources of the Maemo platform and related Nokia developed open source applications are available at [URL with sources of lastest version].
-
The sources of the Maemo platform and related Nokia developed open source applications are available at git.maemo.org. (planned)
+
=== Releases ===
 +
The best timing for contributions is prior to the final version of a release. Alphas and betas are released for that purpose.
-
== Releases ==
+
Early contributions on new releases are encouraged too, noting that UI changes might be difficult to be accepted because of design, localization, usability and end user testing implications.
-
Patches are most welcome in the ongoing alpha/beta release. Bugfixes on new stable releases are encouraged too.
+
=== Submissions ===
-
 
+
Bugfixes need to be referenced in existing or new bugs filed at http://bugs.maemo.org, including the keyword "Patch".  
-
Note that it is very complex for maintainers to apply UI changes on final releases since they might originate new iterations in localization, usability and testing.
+
-
 
+
-
== Submissions ==
+
-
 
+
-
Bugfixes need to be referenced in existing or new bugs filed at https://bugs.maemo.org, including the keyword "[https://bugs.maemo.org/describekeywords.cgi#patch patch]".  
+
Developers can attach patches to the bug report or can host them in their own git directory at git.maemo.org (planned).
Developers can attach patches to the bug report or can host them in their own git directory at git.maemo.org (planned).
-
== Upstream ==
+
=== Upstream ===
-
 
+
Patches to software components developed upstream need to be submitted to their original projects.
-
Patches to software components developed upstream need to be submitted following the contribution guidelines of the original projects.
+
-
 
+
-
If the upstream component has no Maemo specific versioning, it is better to contribute the patch directly upstream. Please notify the Maemo SW maintainers through https://bugs.maemo.org, they might get your patch anyway and help you getting it committed upstream.
+
-
 
+
-
== Quality ==
+
-
 
+
-
Software contributions need to take into account the Maemo [http://maemo.org/maemo_release_documentation/maemo4.1.x/node16.html quality considerations] and [http://maemo.org/maemo_release_documentation/maemo4.1.x/node16.html#SECTION001630000000000000000 coding style].
+
-
 
+
-
Learn more about [[The Good Patch]].
+
-
== License ==
+
It is recommended to notify in bugs.maemo.org the contribution to the related Maemo SW developers by providing URLs to the bug/patch submitted upstream. They might help pushing the patch and/or committing it to the Maemo related component.
-
If you want your patch to be accepted you better use the same license used by the component patched.
+
If the upstream is not Maemo SW but another team at Nokia (for instance Qt SW) then their contribution guidelines prevail.
-
== Copyright ==
+
=== Quality ===
 +
Software contributions need to take into account the Maemo [http://maemo.org/maemo_release_documentation/maemo4.1.x/node16.html quality considerations] and [http://maemo.org/maemo_release_documentation/maemo4.1.x/node16.html#SECTION001630000000000000000] coding style].
-
Developers of significant code contributions retain their copyrights and are credited.
+
=== License ===
 +
The simplest and most sensible license choosed for the patches submitted is the license used by the component patched.
-
Ideas or contributions below 15 lines are usually not considered subject to copyrights. For details see the definition of [http://www.gnu.org/prep/maintain/maintain.html#Legally-Significant legally significant changes] made by the GNU Project.
+
=== Copyright ===
 +
Authors of a creative work retain their copyrights. Bugfixes are generally not considered creative work and don't generate copyrights.
-
[[Category:Development]]
+
In case of doubt check with the maintainers of the component beforehand.
-
[[Category:Community]]
+

Learn more about Contributing to the wiki.


Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!


Cancel | Editing help (opens in new window)
Retrieved from "http://wiki.maemo.org/Maemo_contribution_guidelines"