diff --git a/guide/contribute/contribute.md b/guide/contribute/contribute.md index bb0bf1ce0..b332e6317 100644 --- a/guide/contribute/contribute.md +++ b/guide/contribute/contribute.md @@ -22,34 +22,32 @@ image: https://bitcoin.design/assets/images/guide/contribute/contribute-preview. # Contribute to the Guide -People from around the internet build and shape the Bitcoin Design Guide every day. You are invited to join our open community and help us improve these resources! - -This section shows you how to get involved and start contributing. +Join our open community and help us improve the Bitcoin Design Guide. Here’s where you can get involved and contribute. --- **[Slack channel]({{ site.slack_invite_url }})** -We use the #bitcoin-design-guide channel in the [Bitcoin Design Slack community]({{ site.slack_invite_url }}) to communicate and discuss work on guide. To hear what is going on, see what you can help with, or suggest new contributions please come and say hi. +Head over to the Bitcoin [Bitcoin Design Slack community]({{ site.slack_invite_url }}) and join the #bitcoin-design-guide channel. If you don’t have Slack, you can [download it here](https://slack.com/intl/en-rs/downloads) or on the App Store. + --- **[GitHub](https://github.com/BitcoinDesign/Guide)** -We use Github to host the content of the guide. [Issues](https://github.com/BitcoinDesign/Guide/issues) are used to post ideas for improvements, and proposed changes are posted as [Pull Requests](https://github.com/BitcoinDesign/Guide/pulls). -For questions and ideas we use [Discussions](https://github.com/BitcoinDesign/Guide/discussions). +The Bitcoin Design Guide is hosted on GitHub, an open-source collaboration platform. This is where you can view outstanding [issues](https://github.com/BitcoinDesign/Guide/issues), propose changes, see what needs to be done, and see who’s working alongside you. --- **[Proposing changes]({{ '/guide/contribute/propose-a-change/' | relative_url }})** -Learn the basics of GitHub, an open-source collaboration platform, and propose a change by creating your first pull request. +Learn the basics of collaborating on GitHub so that when you’re ready to make your first pull request, you’ll know how. --- **[Become a reviewer]({{ '/guide/contribute/review/' | relative_url }})** -Get involved in the review process. It's a fantastic entry-point for new contributors and essential for improving the quality and usefulness of the guide. +Get involved in the Bitcoin Design Guide review process. Reviewers are essential to improving the quality and usefulness of the guide. --- @@ -61,14 +59,14 @@ Tips on how to write for the guide. The goal is to achieve a consistent tone acr **[Illustration guidelines]({{ '/guide/contribute/illustration-guidelines/' | relative_url }})** -Notes on how to prepare visuals for use in the guide. We encourage diverse creative expressions, so this page focuses mostly on basics like file names and image sizes. +Creating visuals for the Bitcoin Design Guide? We recommend following these best practices for file naming, image sizing, and on. --- **[Formatting]({{ '/guide/contribute/formatting/' | relative_url }})** -Layout and formatting options available for content pages, from headers and blockquotes to images and embeds. +Layout and formatting options from headers and blockquotes to images and embeds. --- -These contribution guidelines are for the Bitcoin Design Guide project. To get involved with the broader Bitcoin Design community and projects, check out [general contribution guidelines]({{ '/contribute/' | relative_url }}). +These contribution guidelines are for the Bitcoin Design Guide project. To get involved with the broader Bitcoin Design Community and projects, check out [general contribution guidelines]({{ '/contribute/' | relative_url }}).