Maemo contribution guidelines

(patch)
(wikify section headings)
 
(8 intermediate revisions not shown)
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 git.maemo.org. (planned)
The sources of the Maemo platform and related Nokia developed open source applications are available at git.maemo.org. (planned)
-
=== Releases ===
+
== Releases ==
 +
 
Patches are most welcome in the ongoing alpha/beta release. Bugfixes on new stable releases are encouraged too.
Patches are most welcome in the ongoing alpha/beta release. Bugfixes on new stable releases are encouraged too.
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.
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 ===
+
== Submissions ==
-
Bugfixes need to be referenced in existing or new bugs filed at http://bugs.maemo.org, including the keyword "[[https://bugs.maemo.org/describekeywords.cgi#patch patch]]".  
+
 
 +
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 following the contribution guidelines of the 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. If you do so please notify the Maemo SW maintainers through bugs.maemo.org.
+
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 ==
-
=== 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].  
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]].
Learn more about [[The Good Patch]].
-
=== License ===
+
== License ==
 +
 
If you want your patch to be accepted you better use the same license used by the component patched.
If you want your patch to be accepted you better use the same license used by the component patched.
-
=== Copyright ===
+
== Copyright ==
 +
 
Developers of significant code contributions retain their copyrights and are credited.
Developers of significant code contributions retain their copyrights and are credited.
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.
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.
 +
 +
[[Category:Development]]
 +
[[Category:Community]]

Latest revision as of 13:58, 4 March 2011

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:

Contents

[edit] 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.

[edit] Sources

The sources of the Maemo platform and related Nokia developed open source applications are available at git.maemo.org. (planned)

[edit] Releases

Patches are most welcome in the ongoing alpha/beta release. Bugfixes on new stable releases are encouraged too.

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.

[edit] Submissions

Bugfixes need to be referenced in existing or new bugs filed at https://bugs.maemo.org, including the keyword "patch".

Developers can attach patches to the bug report or can host them in their own git directory at git.maemo.org (planned).

[edit] Upstream

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.

[edit] Quality

Software contributions need to take into account the Maemo quality considerations and coding style.

Learn more about The Good Patch.

[edit] License

If you want your patch to be accepted you better use the same license used by the component patched.

[edit] Copyright

Developers of significant code contributions retain their copyrights and are credited.

Ideas or contributions below 15 lines are usually not considered subject to copyrights. For details see the definition of legally significant changes made by the GNU Project.