We'd love for you to contribute and welcome your help. Here are some guidelines to follow:
-
Ensure the bug was not already reported by searching on GitHub under Issues.
-
If you're unable to find an open issue addressing the problem, open a new one. Be sure to include a title and clear description, as much relevant information as possible, and a code sample or an executable test case demonstrating the expected behavior that is not occurring.
Open a new GitHub pull request with the patch following the steps outlined below. Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
Before you submit your pull request consider the following guidelines:
- Search GitHub for an open or closed Pull Request that relates to your submission. You don't want to duplicate effort.
Please follow these steps for all pull requests. These steps are derived from the GitHub flow.
Fork the project on GitHub and clone your fork locally.
git clone https://github.com/<my-github-repo>/solace-samples-template
Make your changes on a new git branch in your fork of the repository.
git checkout -b my-fix-branch master
Commit your changes using a descriptive commit message.
git commit -a -m "Your Commit Message"
Note: the optional commit -a
command line option will automatically "add" and "rm" edited files.
Assuming you have not yet pushed your branch to origin, use git rebase
(not git merge
) to synchronize your work with the main
repository.
$ git fetch upstream
$ git rebase upstream/master
If you have not set the upstream, do so as follows:
$ git remote add upstream https://github.com/SolaceSamples/solace-samples-template
If you have already pushed your fork, then do not rebase. Instead merge any changes from master that are not already part of your branch.
Push your branch to your fork in GitHub:
git push origin my-fix-branch
In GitHub, send a pull request to solace-samples-template:master
.
When fixing an existing issue, use the commit message keywords to close the associated GitHub issue.
- If we suggest changes then:
- Make the required updates.
- Commit these changes to your branch (ex: my-fix-branch)
That's it! Thank you for your contribution!
- Open a GitHub enhancement request issue and describe the new functionality.
-
Add your feature source file under src/features/newFeature.js
-
Add your feature markdown file under _docs/feature_newFeature.md
-
Update the _docs/tutorials.yml to include the new feature by appending your feature name to the features list
features: - feature-1 - feature_newFeature
- Ask any question about the code or how to use Solace messaging in the Solace community.