/BB10-WebWorks-Community-Samples

WebWorks Samples for the BlackBerry 10 Platform contributed by the Community

Primary LanguageHTMLApache License 2.0Apache-2.0

BB10-WebWorks-Community-Samples for WebWorks 2.0

Note: This branch is in the process of being updated for the release of WebWorks 2.0, which is based on Cordova. We are starting from the Existing code though, so anything last changed before the creation of this branch (Nov 14 2013) has not been updated yet. We are prioritizing the sample list and working towards the release date but please be aware of this before attempting to use this code. The README files will be updated when a sample is ready as well.

WebWorks Samples for the BlackBerry 10 Platform contributed by the Community. This is a companion to the BB10-WebWorks-Samples repository of official samples.

Samples in this repository are contributed by the community, including RIM and non-RIM developers. We will attempt to keep the samples valid through new releases of the platform but we do not guarantee it, unlike with the official samples.

All APIs shared in this repository are Open Source under the Apache 2.0 License

To contribute code to this repository you must be signed up as an official contributor.

Code Organization

Each Sample added to the repository should be placed in its own directory. Make sure you name the directory something simple, yet descriptive. Each Sample must also have a README.md file at the root of its directory. This README needs to indicate the Author of the API, devices and OS versions it was tested on, and information about the application and how to use it.

Contributing Samples

To add new Samples or make modifications to existing Samples:

  1. Fork the BB10-WebWorks-Community-Samples repository
  2. Make the changes/additions to your fork
  3. Send a pull request from your fork back to the BB10-WebWorks-Community-Samples repository
  4. If you made changes to code which you are NOT the owner, send a message via github messages to the Author(s) of the Sample to indicate that you have a pull request for them to review

Governence

The code for each of the WebWorks Samples is managed by the author of the Sample. When a pull request comes in for a specific Sample the Author(s) should be notified by the pull request owner to perform a code review. When the author indicates that the pull request is ready to be merged (via a comment on the pull request) they can then send a message to a committer through github messages to have the changes merged.

If there are more than one Author for a specific Sample, only one Author is required to indicate that the pull request is ready. If there's more than one Sample affected by a pull request, at least one Author from each Sample must code review the pull request and indicate that it is ready to be merged before the pull request can be merged.

Ownership Transfer: An Author can transfer ownership to another Author by opening up an Issue where both the original Author requests ownership to be transfered to the new Author, and the new Author agrees to take ownership of the code.
The README for the Sample should be updated to indicate the new Author.

Bug Reporting and Feature Requests

If you find a bug in a Sample, or have an enhancement request, simply file an Issue for the Sample.

Disclaimer

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.