# Contributing We'd love for you to contribute to our source code and to make **Webex React Widgets** even better than it is today! If you would like to contribute to this repository by adding features, enhancements or bug fixes, you must follow our process: 1. Let core members know about your proposal by posting a message in the [contributor's Webex space](https://eurl.io/#Bk9WGfRcB) 2. A core member will review your proposal and if necessary may suggest to have a meeting to better understand your approach 3. If your proposal is approved you should start coding at this point 4. We recommend opening a draft PR to receive feedback before finalizing your solution - When opening a draft PR, specify with PR comments where in the code you would like to get feedback 5. Before opening a PR ensure **all** [PR guidelines](#submitting-a-pull-request) are followed 6. Let core members know about your PR by posting a message in the [contributor's Webex space](https://eurl.io/#Bk9WGfRcB) 7. Core members will review the pull request and provide feedback when necessary - If a PR is too large, you may be asked to break it down into multiple smaller-scoped PRs 8. Once the PR is approved by a core member, it will be merged 9. Celebrate! Your code is released 🎈🎉🍻 ## Table of Contents - [Contributing](#contributing) - [Reporting Issues](#reporting-issues) - [Contributing Code](#contributing-code) - [Build Dependencies](#build-dependencies) - [Git Commit Guidelines](#git-commit-guidelines) - [Commit Message Format](#commit-message-format) - [Revert](#revert) - [Type](#type) - [Scope](#scope) - [Subject](#subject) - [Body](#body) - [Footer](#footer) - [Running the tests](#running-the-tests) - [Static Analysis (e.g. linting)](#static-analysis) - [Submitting a Pull Request](#submitting-a-pull-request) ## Reporting Issues Please reach out to our developer support team for any issues you may be experiencings with the SDK. - - ## Contributing Code ### Build Dependencies Before you can build the Cisco Webex React Widgets, you will need the following dependencies: - [Node.js](https://nodejs.org/) (LTS) - We recommend using [nvm](https://github.com/creationix/nvm) (or [nvm-windows](https://github.com/coreybutler/nvm-windows)) to easily switch between Node.js versions. - Run `nvm use` to set your node version to the one this package expects. If it is not installed, this program will tell you the command needed to install the required version. - Install the latest npm to enable security audits using `npm install npm@latest -g` - [Git](https://git-scm.com/) ### Git Commit Guidelines As part of the build process, commits are run through [conventional changelog](https://github.com/conventional-changelog/conventional-changelog) to generate the changelog. Please adhere to the following guidelines when formatting your commit messages. #### Commit Message Format Each commit message consists of a **header**, a **body** and a **footer**. The header has a special format that includes a **type**, a **scope** and a **subject**: ``` text ():