Commit 0a045757 authored by Ian Craggs's avatar Ian Craggs

Update contributing file

parent e5a1a084
Contributing to Paho Contributing to Paho
==================== ====================
Thanks for your interest in this project. Thanks for your interest in this project.
Project description: Project description:
-------------------- --------------------
The Paho project has been created to provide scalable open-source implementations of open and standard messaging protocols aimed at new, existing, and emerging applications for Machine-to-Machine (M2M) and Internet of Things (IoT). The Paho project has been created to provide scalable open-source implementations of open and standard messaging protocols aimed at new, existing, and emerging applications for Machine-to-Machine (M2M) and Internet of Things (IoT).
Paho reflects the inherent physical and cost constraints of device connectivity. Its objectives include effective levels of decoupling between devices and applications, designed to keep markets open and encourage the rapid growth of scalable Web and Enterprise middleware and applications. Paho is being kicked off with MQTT publish/subscribe client implementations for use on embedded platforms, along with corresponding server support as determined by the community. Paho reflects the inherent physical and cost constraints of device connectivity. Its objectives include effective levels of decoupling between devices and applications, designed to keep markets open and encourage the rapid growth of scalable Web and Enterprise middleware and applications. Paho is being kicked off with MQTT publish/subscribe client implementations for use on embedded platforms, along with corresponding server support as determined by the community.
- https://projects.eclipse.org/projects/technology.paho - https://projects.eclipse.org/projects/technology.paho
Developer resources: Source
-------------------- ------
Information regarding source code management, builds, coding standards, and more. The Paho Python code is stored in a git repository. The URLs to access it are:
- https://projects.eclipse.org/projects/technology.paho/developer ssh://<username>@git.eclipse.org:29418/paho/org.eclipse.paho.mqtt.python
https://<username>@git.eclipse.org/r/paho/org.eclipse.paho.mqtt.python
Contributor License Agreement:
------------------------------ A web browsable repository is available at
Before your contribution can be accepted by the project, you need to create and electronically sign the Eclipse Foundation Contributor License Agreement (CLA). http://git.eclipse.org/c/paho/org.eclipse.paho.mqtt.python.git
- http://www.eclipse.org/legal/CLA.php Contributing a patch
--------------------
Contact:
-------- The Paho repositories are accessed through Gerrit, the code review
project, which makes it possible for anybody to clone the repository, make
Contact the project developers via the project's "dev" list. changes and push them back for review and eventual acceptance into the project.
- https://dev.eclipse.org/mailman/listinfo/paho-dev To do this, you must follow a few steps. The first of these are described at
Search for bugs: - https://wiki.eclipse.org/Development_Resources/Contributing_via_Git
----------------
* Sign the Eclipse CLA
This project uses Bugzilla to track ongoing development and issues. * Use a valid commit record, including a signed-off-by entry.
- https://bugs.eclipse.org/bugs/buglist.cgi?product=Paho There are further details at
Create a new bug: - https://wiki.eclipse.org/Development_Resources/Handling_Git_Contributions
-----------------
Once the patch is pushed back to Gerrit, the project committers will be
Be sure to search for existing bugs before you create another one. Remember that contributions are always welcome! 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
- https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Paho straightforward, the steps at
https://git.eclipse.org/r/Documentation/cmd-hook-commit-msg.html should be
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
by the contributor and is less than 250 lines (and meets the needs of the
project), then it can be committed to the main repository. If not, more steps
are required. These are detailed in the legal process poster:
- http://www.eclipse.org/legal/EclipseLegalProcessPoster.pdf
Developer resources:
--------------------
Information regarding source code management, builds, coding standards, and more.
- https://projects.eclipse.org/projects/technology.paho/developer
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).
- http://www.eclipse.org/legal/CLA.php
Contact:
--------
Contact the project developers via the project's "dev" list.
- https://dev.eclipse.org/mailman/listinfo/paho-dev
Search for bugs:
----------------
This project uses Bugzilla to track ongoing development and issues.
- https://bugs.eclipse.org/bugs/buglist.cgi?product=Paho
Create a new bug:
-----------------
Be sure to search for existing bugs before you create another one. Remember that contributions are always welcome!
- https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Paho
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment