* refactor(lib, example, example_full): use streams for communication channel and is ios browser * feat: add abstract toJson() to message * refactor: add deprecations for nearby_service * feat(example): update main.dart * feat(nearby_service): add comments * feat(nearby_service_platform_interface): add deprecation to getConnectedDeviceStream * feat(nearby_service/message): add concrete implementation for toJson() * feat(nearby_service/android): add deprecations * fix(nearby_service/android): reset check for android device * fix(nearby_service/ios): change ios service to deprecations variant * chore(nearby_service): edit deprecation messages * chore: update gitignore * doc: add CONTRIBUTING file * doc: update CONTRIBUTING file * chore: update CONTRIBUTING.md * chore: update CONTRIBUTING.md * chore: version 0.1.0 * fix(example_full): move startListeningCommunicationChannelState() upper
62 lines
3.6 KiB
Markdown
62 lines
3.6 KiB
Markdown
[](https://xenikii.one)
|
||
[](https://github.com/ksenia312/nearby_service/blob/main/LICENSE)
|
||
[](https://pub.dev/packages/nearby_service)
|
||
[](https://pub.dev/packages/nearby_service)
|
||
|
||
## Contributing to Nearby Service
|
||
|
||
Thank you for considering contributing to the Nearby Service package! Please follow the guidelines below based on your
|
||
use case.
|
||
|
||
#### Reporting a bug
|
||
|
||
If you have found a bug, please follow these steps:
|
||
|
||
1. **Search for existing issues**: Before opening a new issue, please check
|
||
the [Issues](https://github.com/ksenia312/nearby_service/issues) to see if the bug has already been reported.
|
||
2. **Open a new Bug Report issue**: If the bug has not been reported yet, open a new
|
||
issue [here](https://github.com/ksenia312/nearby_service/issues/new/choose) and use template `Bug Report` to indicate
|
||
that this is a bug report.
|
||
3. **Provide details**: Include a clear and concise description of the bug, steps to reproduce it, and any relevant logs
|
||
or screenshots.
|
||
|
||
#### Suggesting an improvement or feature
|
||
|
||
If you have an idea for an improvement or a new feature, follow these steps:
|
||
|
||
1. **Search for existing issues**: Check the [Issues](https://github.com/ksenia312/nearby_service/issues) to see if your
|
||
suggestion has already been made.
|
||
2. **Open a new Feature Request issue**: If not, open a new
|
||
issue [here](https://github.com/ksenia312/nearby_service/issues/new/choose) and use
|
||
template `Feature Request` to indicate that this is a suggestion for improvement.
|
||
3. **Describe your suggestion**: Provide a detailed description of the improvement or feature, including potential use
|
||
cases and any other relevant information.
|
||
|
||
#### Submitting a bug fix or improvement
|
||
|
||
If you have created a fix for a bug or an improvement, please follow these steps:
|
||
|
||
1. **Search for existing issues**: Ensure the issue has not already been fixed or the improvement has not been
|
||
implemented by checking the [Issues](https://github.com/ksenia312/nearby_service/issues).
|
||
2. **Fork the repository**: Fork the [Nearby Service repository](https://github.com/ksenia312/nearby_service) to your
|
||
own GitHub account.
|
||
3. **Create a new branch**: In your forked repository, create a new branch for your fix or improvement.
|
||
4. **Implement your fix or improvement**: Make your changes in the new branch.
|
||
5. **Open a Pull Request**: Once your changes are complete, open a Pull Request (PR) from your forked repository’s
|
||
branch to the `main` branch of the original repository.
|
||
6. **Fill in the PR template**: In your PR, fill in the PR template with the appropriate information.
|
||
|
||
#### Asking a question about nearby_service or source code
|
||
|
||
If you have a question about how to use Nearby Service or about the source code, please follow these steps:
|
||
|
||
1. **Search for existing questions**: Check the [Issues](https://github.com/ksenia312/nearby_service/issues) to see if
|
||
your question has already been answered.
|
||
2. **Open a new Question issue**: If your question has not been addressed, open a new
|
||
issue [here](https://github.com/ksenia312/nearby_service/issues/new/choose) and use one of `Question` templates to
|
||
indicate that this is a question.
|
||
3. **Describe your question**: Clearly state your question and provide any necessary context.
|
||
|
||
---
|
||
Your effort is appreciated 💗
|