BB10 WebWorks Samples Repository 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.
The BB10-WebWorks-Samples repository is where official WebWorks samples for BlackBerry 10 are hosted. For Community Samples, please refer to the BB10-WebWorks-Community-Samples Repository.
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.
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.
To add new Samples or make modifications to existing Samples:
- Fork the BB10-WebWorks-Samples repository
- Make the changes/additions to your fork
- Send a pull request from your fork back to the BB10-WebWorks-Samples repository
- 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
- If you made changes to code which you own, send a message via github messages to one of the Committers listed below to have your code merged
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.
If the Author of the pull request is the actual owner of the Sample, then the Author should send a message to a committer via github messages to have their changes merged.
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.
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.