Add a contributing section to the sway book (FuelLabs#962)

* docs:add contributing_to_sway to book * style:fix typo and heading types * docs:add contributing.md * Update docs/src/reference/contributing_to_sway.md Co-authored-by: John Adler <[email protected]> * Update docs/src/reference/contributing_to_sway.md Co-authored-by: John Adler <[email protected]> * Update docs/src/reference/contributing_to_sway.md Co-authored-by: John Adler <[email protected]> * Update docs/src/reference/contributing_to_sway.md Co-authored-by: John Adler <[email protected]> * Update docs/src/reference/contributing_to_sway.md Co-authored-by: John Adler <[email protected]> * Update docs/src/reference/contributing_to_sway.md Co-authored-by: John Adler <[email protected]> * Update docs/src/reference/contributing_to_sway.md Co-authored-by: John Adler <[email protected]> * Update docs/src/reference/contributing_to_sway.md Co-authored-by: John Adler <[email protected]> * fixup:remove contributing.md & add to README.md * docs:reword small section on getting set up * docs:update guidelines to recommend forking * Update README.md Co-authored-by: John Adler <[email protected]> * Update docs/src/reference/contributing_to_sway.md Co-authored-by: mitchmindtree <[email protected]> Co-authored-by: John Adler <[email protected]> Co-authored-by: mitchmindtree <[email protected]>
parmiseth · Mar 20, 2022 · b474e64 · b474e64
1 parent 9d8de93
commit b474e64
Show file tree

Hide file tree

Showing 4 changed files with 109 additions and 0 deletions.
diff --git a/README.md b/README.md
@@ -44,3 +44,9 @@ Confirm the Sway toolchain built successfully:
 ```sh
 cargo run --bin forc -- --help
 ```
+
+## Contributing to Sway
+
+We welcome contributions to Sway!
+
+Please see the [Contributing To Sway](https://fuellabs.github.io/sway/latest/reference/contributing_to_sway.html) section of the Sway book for guidelines and instructions to help you get started.
diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
@@ -51,3 +51,4 @@
   - [Temporary Workarounds](./reference/temporary_workarounds.md)
   - [Differences From Solidity](./reference/solidity_differences.md)
   - [Differences From Rust](./reference/rust_differences.md)
+  - [Contributing To Sway](./reference/contributing_to_sway.md)
diff --git a/docs/src/reference/contributing_to_sway.md b/docs/src/reference/contributing_to_sway.md
@@ -0,0 +1,101 @@
+# Contributing To Sway
+
+Thanks for your interest in contributing to Sway! This document outlines the process for installing and setting up the Sway toolchain for development, as well as some conventions on contributing to Sway.
+
+If you run into any difficulties getting started, you can always ask questions on our [Discord](https://discord.gg/xfpK4Pe).
+
+## Building and setting up a development workspace
+
+See the [introduction](../introduction/index.md) section for instructions on installing and setting up the Sway toolchain.
+
+## Getting the repository
+
+1. Visit the [Sway](https://github.com/FuelLabs/sway) repo and fork the project.
+2. Then clone your forked copy to your local machine and get to work.
+
+```sh
+git clone https://github.com/FuelLabs/sway
+cd sway
+```
+
+## Building and testing
+
+The following steps will run the sway test suite and ensure that everything is set up correctly.
+
+First, open a new terminal and start `fuel-core` with:
+
+```sh
+fuel-core
+```
+
+Then open a second terminal, cd into the `sway` repo and run:
+
+```sh
+cargo run --bin test
+```
+
+After the test suite runs, you should see:
+
+```console
+Tests passed.
+_n_ tests run (0 skipped)
+```
+
+Congratulations! You've now got everything setup and are ready to start making contributions.
+
+## Finding something to work on
+
+There are many ways in which you may contribute to the Sway project, some of which involve coding knowledge and some which do not. A few examples include:
+
+- Reporting bugs
+- Adding documentation to the Sway book
+- Adding new features or bugfixes for which there is already an open issue
+- Making feature requests
+
+Check out our [Help Wanted](https://github.com/FuelLabs/sway/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22), [Sway Book](https://github.com/FuelLabs/sway/issues?q=is%3Aopen+is%3Aissue+label%3A%22The+Sway+Book%22) or [Good First Issue](https://github.com/FuelLabs/sway/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) issues to find a suitable task.
+
+If you are planning something big, for example, related to multiple components or changes current behaviors, make sure to open an issue to discuss with us before starting on the implementation.
+
+## Contribution flow
+
+This is a rough outline of what a contributor's workflow looks like:
+
+- Make sure what you want to contribute is already tracked as an issue.
+  - We may discuss the problem and solution in the issue.
+- Create a Git branch from where you want to base your work. This is usually master.
+- Write code, add test cases, and commit your work.
+- Run tests and make sure all tests pass.
+- If the PR contains any breaking changes, add the breaking label to your PR.
+- Push your changes to a branch in your fork of the repository and submit a pull request.
+  - Make sure mention the issue, which is created at step 1, in the commit message.
+- Your PR will be reviewed and some changes may be requested.
+  - Once you've made changes, your PR must be re-reviewed and approved.
+  - If the PR becomes out of date, you can use GitHub's 'update branch' button.
+  - If there are conflicts, you can merge and resolve them locally. Then push to your PR branch.
+    Any changes to the branch will require a re-review.
+- Our CI system (Github Actions) automatically tests all authorized pull requests.
+- Use Github to merge the PR once approved.
+
+Thanks for your contributions!
+
+### Linking issues
+
+Pull requests should be linked to at least one issue in the same repo.
+
+If the pull request resolves the relevant issues, and you want GitHub to close these issues automatically after it merged into the default branch, you can use the syntax (`KEYWORD #ISSUE-NUMBER`) like this:
+
+```
+close #123
+```
+
+If the pull request links an issue but does not close it, you can use the keyword `ref` like this:
+
+```
+ref #456
+```
+
+Multiple issues should use full syntax for each issue and separate by a comma, like:
+
+```
+close #123, ref #456
+```
diff --git a/docs/src/reference/index.md b/docs/src/reference/index.md
@@ -3,3 +3,4 @@
 - [Temporary Workarounds](./temporary_workarounds.md)
 - [Differences from Rust](./rust_differences.md)
 - [Differences from Solidity](./solidity_differences.md)
+- [Contributing to Sway](./contributing_to_sway.md)