textiot

# Contributing to Textile The following is a set of guidelines for contributing to Textile Mobile and its related projects, which are hosted in the [Textile organization](https://github.com/textileio). These are just guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request. Note that Textile is an evolving project, so expect things to change over time as the team learns, listens and refines how we work with the community. #### Table Of Contents [What should I know before I get started?](#what-should-i-know-before-i-get-started) - [Code of Conduct](#code-of-conduct) [How Can I Contribute?](#how-can-i-contribute) - [Reporting Bugs](#reporting-bugs) - [Suggesting Enhancements](#suggesting-enhancements) [Additional Notes](#additional-notes) - [Issue Labels](#issue-labels) ## What should I know before I get started? ### Code of Conduct This project adheres to the Contributor Covenant [code of conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior to [contact@textile.io](mailto:contact@textile.io). ## How Can I Contribute? ### Developing locally #### How to Setup **Step 1:** git clone this repo: **Step 2:** cd to the cloned repo: **Step 3:** Install the Application with `yarn` or `npm i` #### How to Run App 1. cd to the repo 2. Run Build for either OS - for iOS - run `react-native run-ios` - for Android - Run Genymotion - run `react-native run-android` ### Reporting Bugs This section guides you through submitting a bug report for Textile Mobile. Following these guidelines helps maintainers and the community understand your report, reproduce the behavior, and find related reports. Before creating bug reports, please check [this list](https://github.com/textileio/textile-mobile/labels/bug) as you might find out that you don't need to create one. When you are creating a bug report, please [include as many details as possible](#how-do-i-submit-a-good-bug-report). #### Before Submitting A Bug Report **Perform a [cursory search](https://github.com/textileio/textile-mobile/labels/bug)** to see if the problem has already been reported. If it does exist, add a :thumbsup: to the issue to indicate this is also an issue for you, and add a comment to the existing issue if there is extra information you can contribute. #### How Do I Submit A (Good) Bug Report? Bugs are tracked as [GitHub issues](https://guides.github.com/features/issues/). Simply create an issue on the [Textile issue tracker](https://github.com/textileio/textile-mobile/issues). The information we are interested in includes: - details about your environment - which build, which operating system - details about reproducing the issue - what steps to take, what happens, how often it happens - other relevant information - log files, screenshots, etc. ### Suggesting Enhancements This section guides you through submitting an enhancement suggestion for Textile Mobile, including completely new features and minor improvements to existing functionality. Following these guidelines helps maintainers and the community understand your suggestion :pencil: and find related suggestions :mag_right:. Before creating enhancement suggestions, please check [this list](https://github.com/textileio/textile-mobile/labels/bug) as you might find out that you don't need to create one. When you are creating an enhancement suggestion, please [include as many details as possible](#how-do-i-submit-a-good-enhancement-suggestion). Include the steps that you imagine you would take if the feature you're requesting existed. #### Before Submitting An Enhancement Suggestion **Perform a [cursory search](https://github.com/textileio/textile-mobile/labels/enhancement)** to see if the enhancement has already been suggested. If it has, add a :thumbsup: to indicate your interest in it, or comment if there is additional information you would like to add. #### How Do I Submit A (Good) Enhancement Suggestion? Enhancement suggestions are tracked as [GitHub issues](https://guides.github.com/features/issues/). Simply create an issue on the [Textile issue tracker](https://github.com/textileio/textile-mobile/issues) and provide the following information: - **Use a clear and descriptive title** for the issue to identify the suggestion. - **Provide a step-by-step description of the suggested enhancement** in as much detail as possible. This additional context helps the maintainers to understand the enhancement from your perspective - **Explain why this enhancement would be useful** to Textile users. - **Include screenshots and animated GIFs** if relevant to help you demonstrate the steps or point out the part of Textile which the suggestion is related to. - **List some other applications where this enhancement exists, if applicable.** ## Additional Notes ### Issue Labels This section lists the labels we use to help us track and manage issues and pull requests. | Label name | :mag_right: | Description | | ----------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | `enhancement` | [search](https://github.com/textileio/textile-mobile/labels/enhancement) | Feature requests. | | `bug` | [search](https://github.com/textileio/textile-mobile/labels/bug) | Confirmed bugs or reports that are very likely to be bugs. | | `more-information-needed` | [search](https://github.com/textileio/textile-mobile/labels/more-information-needed) | More information needs to be collected about these problems or feature requests (e.g. steps to reproduce). | | `reviewer-needs-to-reproduce` | [search](https://github.com/textileio/textile-mobile/labels/reviewer-needs-to-reproduce) | Likely bugs, but haven't been reliably reproduced by a reviewer. | | `stale` | [search](https://github.com/textileio/textile-mobile/labels/stale) | Issues that are inactive and marked to be closed. | | `iOS` | [search](https://github.com/textileio/textile-mobile/labels/iOS) | Issues specific to iOS users. | | `Android` | [search](https://github.com/textileio/textile-mobile/labels/Android) | Issues specific to Android users. |