2014-05-08 21:41:59 +00:00
|
|
|
Contributing to Mosquitto
|
|
|
|
=========================
|
|
|
|
|
|
|
|
Thank you for your interest in this project.
|
|
|
|
|
|
|
|
Project description:
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
The Mosquitto project has been created to provide a light weight, open-source
|
|
|
|
implementation, of an MQTT broker to allow new, existing, and emerging
|
|
|
|
applications for Machine-to-Machine (M2M) and Internet of Things (IoT).
|
|
|
|
|
2014-11-25 17:14:15 +00:00
|
|
|
- <https://projects.eclipse.org/projects/technology.mosquitto>
|
2014-05-08 21:41:59 +00:00
|
|
|
|
|
|
|
|
|
|
|
Source
|
|
|
|
------
|
|
|
|
|
2014-11-25 23:29:24 +00:00
|
|
|
The Mosquitto code is stored in a git repository. The URL for anonymous access is:
|
2014-05-08 21:41:59 +00:00
|
|
|
|
2014-11-25 23:29:24 +00:00
|
|
|
- http://git.eclipse.org/gitroot/mosquitto/org.eclipse.mosquitto.git
|
|
|
|
|
|
|
|
Access via Gerrit (for code review) is through the following URLs:
|
|
|
|
|
|
|
|
- ssh://username@git.eclipse.org:29418/mosquitto/org.eclipse.mosquitto
|
|
|
|
- https://username@git.eclipse.org/r/mosquitto/org.eclipse.mosquitto
|
2014-05-08 21:41:59 +00:00
|
|
|
|
|
|
|
A web browsable repository is available at
|
|
|
|
|
2014-11-25 17:14:15 +00:00
|
|
|
- <http://git.eclipse.org/c/mosquitto/org.eclipse.mosquitto.git>
|
2014-05-08 21:41:59 +00:00
|
|
|
|
|
|
|
Contributing a patch
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
The Mosquitto repositories are accessed through Gerrit, the code review
|
|
|
|
project, which makes it possible for anybody to clone the repository, make
|
|
|
|
changes and push them back for review and eventual acceptance into the project.
|
|
|
|
|
|
|
|
To do this, you must follow a few steps. The first of these are described at
|
|
|
|
|
2014-11-25 17:14:15 +00:00
|
|
|
- <https://wiki.eclipse.org/Development_Resources/Contributing_via_Git>
|
2014-05-08 21:41:59 +00:00
|
|
|
|
|
|
|
* Sign the Eclipse CLA
|
|
|
|
* Use a valid commit record, including a signed-off-by entry.
|
|
|
|
|
|
|
|
There are further details at
|
|
|
|
|
2014-11-25 17:14:15 +00:00
|
|
|
- <https://wiki.eclipse.org/Development_Resources/Handling_Git_Contributions>
|
2014-05-08 21:41:59 +00:00
|
|
|
|
2015-11-01 16:39:40 +00:00
|
|
|
If your contribution is a fix for a bug, please use the 'fixes' branch as the
|
|
|
|
base for your work. If you are proposing new behaviour/features please use the
|
|
|
|
'develop' branch.
|
|
|
|
|
2014-05-08 21:41:59 +00:00
|
|
|
Once the patch is pushed back to Gerrit, the project committers will be
|
|
|
|
informed and they will undertake a review of the code. The patch may need
|
|
|
|
modifying for some reason. In order to make amending commits more
|
|
|
|
straightforward, the steps at
|
2014-11-25 17:14:15 +00:00
|
|
|
<https://git.eclipse.org/r/Documentation/cmd-hook-commit-msg.html> should be
|
2014-05-08 21:41:59 +00:00
|
|
|
followed. This automatically inserts a "Change-Id" entry to your commit message
|
|
|
|
which allows you to amend commits and have Gerrit track them as the same
|
|
|
|
change.
|
|
|
|
|
|
|
|
What happens next depends on the content of the patch. If it is 100% authored
|
2014-10-31 17:24:19 +00:00
|
|
|
by the contributor and is less than 1000 lines (and meets the needs of the
|
2014-05-08 21:41:59 +00:00
|
|
|
project), then it can be committed to the main repository. If not, more steps
|
|
|
|
are required. These are detailed in the legal process poster:
|
|
|
|
|
2014-11-25 17:14:15 +00:00
|
|
|
- <http://www.eclipse.org/legal/EclipseLegalProcessPoster.pdf>
|
2014-05-08 21:41:59 +00:00
|
|
|
|
|
|
|
Developer resources:
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
More information regarding source code management, builds, coding standards,
|
|
|
|
and other topics can be found at.
|
|
|
|
|
2014-11-25 17:14:15 +00:00
|
|
|
- <https://projects.eclipse.org/projects/technology.mosquitto/developer>
|
2014-05-08 21:41:59 +00:00
|
|
|
|
|
|
|
|
|
|
|
Contributor License Agreement:
|
|
|
|
------------------------------
|
|
|
|
|
|
|
|
Before your contribution can be accepted by the project, you need to create and
|
|
|
|
electronically sign the Eclipse Foundation Contributor License Agreement (CLA).
|
|
|
|
|
2014-11-25 17:14:15 +00:00
|
|
|
- <http://www.eclipse.org/legal/CLA.php>
|
2014-05-08 21:41:59 +00:00
|
|
|
|
|
|
|
|
|
|
|
Contact:
|
|
|
|
--------
|
|
|
|
|
|
|
|
Contact the project developers via the project's "dev" list.
|
|
|
|
|
2014-11-25 17:14:15 +00:00
|
|
|
- <https://dev.eclipse.org/mailman/listinfo/mosquitto-dev>
|
2014-05-08 21:41:59 +00:00
|
|
|
|
|
|
|
|
|
|
|
Search for bugs:
|
|
|
|
----------------
|
|
|
|
|
|
|
|
This project uses Bugzilla to track ongoing development and issues.
|
|
|
|
|
2014-11-25 17:14:15 +00:00
|
|
|
- <https://bugs.eclipse.org/bugs/buglist.cgi?product=Mosquitto>
|
2014-05-08 21:41:59 +00:00
|
|
|
|
|
|
|
Create a new bug:
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
Be sure to search for existing bugs before you create another one. Remember that contributions are always welcome!
|
|
|
|
|
2014-11-25 17:14:15 +00:00
|
|
|
- <https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Mosquitto>
|