Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion 404.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ layout: error
<h1>404</h1>
<p class="message">
Oops, we couldn’t find Satoshi!<br>
For help please visit <a class="action-link" href="https://bitcoindesign.slack.com/">our slack</a>.
For help please visit <a class="action-link" href="https://discord.gg/K7aQ5PErht">our Discord</a>.
</p>
<a class="action-button" href="/">Homepage</a>
</div>
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,17 @@

This is the repository for the [Bitcoin Design Guide](https://bitcoin.design/guide/), and the [bitcoin.design](https://bitcoin.design) community website.

Discussion and collaboration is taking place in the [Bitcoin Design Slack](https://join.slack.com/t/bitcoindesign/shared_invite/zt-10sxfovaq-isViijl4RThKRs_TsAQnuA) (#bitcoin-design-guide).
Discussion and collaboration is taking place in the [Bitcoin Design Discord](https://discord.gg/K7aQ5PErht) (#bitcoin-design-guide).

The [Bitcoin Design Guide](https://bitcoin.design/guide/) is a free open-source community resource that helps designers, developers and others working on non-custodial bitcoin-products to create better experiences faster. We hope that, over time, it will cover all relevant types of products, including consumer wallets, merchant interactions, exchanges and more. Better products and experiences should ultimately make it more appealing for anyone to own and use bitcoin.

An equally important goal is that the process of creating this guide nurtures an open-source bitcoin design community that can carry this, and other projects forward longer term. The [Bitcoin Design Slack](https://join.slack.com/t/bitcoindesign/shared_invite/zt-10sxfovaq-isViijl4RThKRs_TsAQnuA) and the [bitcoin.design](https://bitcoin.design) website are the first steps in this direction.
An equally important goal is that the process of creating this guide nurtures an open-source bitcoin design community that can carry this, and other projects forward longer term. The [Bitcoin Design Discord](https://discord.gg/K7aQ5PErht) and the [bitcoin.design](https://bitcoin.design) website are the first steps in this direction.

---

## Process and how to contribute

The process of creating the guide is meant to be as open and decentralized as possible, resulting in a sustainable model to run projects with the community. Most of the discussion happens in the [Bitcoin Design Slack](https://join.slack.com/t/bitcoindesign/shared_invite/zt-10sxfovaq-isViijl4RThKRs_TsAQnuA), in the #bitcoin-design-guide channel, and here on GitHub in [Issues](https://github.com/BitcoinDesign/Guide/issues), [Pull requests](https://github.com/BitcoinDesign/Guide/pulls) and [Discussions](https://github.com/BitcoinDesign/Guide/discussions). Also see the [roadmap](https://github.com/orgs/BitcoinDesign/projects/2) for an overview of current and upcoming activities.
The process of creating the guide is meant to be as open and decentralized as possible, resulting in a sustainable model to run projects with the community. Most of the discussion happens in the [Bitcoin Design Discord](https://discord.gg/K7aQ5PErht), in the #bitcoin-design-guide channel, and here on GitHub in [Issues](https://github.com/BitcoinDesign/Guide/issues), [Pull requests](https://github.com/BitcoinDesign/Guide/pulls) and [Discussions](https://github.com/BitcoinDesign/Guide/discussions). Also see the [roadmap](https://github.com/orgs/BitcoinDesign/projects/2) for an overview of current and upcoming activities.

You can read more about [how to contribute](https://bitcoin.design/guide/contribute/).

Expand Down
3 changes: 2 additions & 1 deletion _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ github_username: jekyll

github_repository_url: "https://github.com/BitcoinDesign/Guide/"
slack_invite_url: "https://join.slack.com/t/bitcoindesign/shared_invite/zt-1rxp55chx-dH6pWlTtWBqRw7VztgvBGA"
discord_invite_url: "https://discord.gg/K7aQ5PErht"
youtube_url: "https://www.youtube.com/c/BitcoinDesign"
twitter_url: "https://twitter.com/bitcoin_design"

Expand Down Expand Up @@ -69,12 +70,12 @@ twitter:
username: bitcoin_design
card: summary


social:
name: Bitcoin Design
links:
github: bitcoindesign
slack: bitcoindesign
discord: bitcoindesign
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So we have the user/server names http://bitcoindesign.slack.com and https://github.com/bitcoindesign, but is there an equivalent like http://bitcoindesign.discord.com? As far as I know there are no unique server "usernames". If you know that this exists, we can keep it. Otherwise, let's remove this line.

Copy link
Contributor

@DanGould DanGould Apr 18, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it'd be good to call these "subdomains" instead of "links," or hmm I'm not sure maybe a comment with the examples here

I asked Stephen what they were earlier in review but the answer wasn't clear. Glad you know!

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@GBKS No, I don't think we have a unique subdomain for our Discord instance. Not sure it's even possible.

I'm not entirely clear how that SEO jekyll tag actually maps those domains or whatever from the simple data in that JSON. I'm fine if you want to PR it out of there.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did a bit more Googleroni, and apparently search engines ignore this, and it should be an Array of URLs. So maybe we just delete it.


exclude:
- README.md
Expand Down
11 changes: 11 additions & 0 deletions _includes/discord.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions _includes/home-banner.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ <h1>
</h1>
<p>Open-source design for bitcoin products.</p>
<div class="home-banner-buttons-wrapper">
<a id="link-button-1" href="{{ site.slack_invite_url }}" rel="me">Join us on Slack</a>
<a id="link-button-1" href="{{ site.discord_invite_url }}" rel="me">Join us on Discord</a>
<a id="link-button-2" href="{{ "/guide" | relative_url }}" >Design guide</a>
</div>
</div>
Expand All @@ -19,7 +19,7 @@ <h1>
</section>
<section class="home-banner-info">
<div class="home-banner-info-wrapper">
<p>Header design by <a id="home-banner-info-author" href="{{ site.slack_invite_url }}" target="blank">Author</a></p>
<p>Header design by <a id="home-banner-info-author" href="{{ site.discord_invite_url }}" target="blank">Author</a></p>
<div class="home-banner-info-options">
<a href="{{ "/submit-header-design" | relative_url }}" target="blank">Submit your own</a>
<button id="home-banner-info-next">Next</button>
Expand Down
2 changes: 1 addition & 1 deletion _includes/next-previous.html
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
<button aria-expanded="false" aria-controls="next-previous--feedback__modal">Feedback & questions?</button>
<div id="next-previous--feedback__modal" class="next-previous--feedback__options" aria-hidden="true" hidden>
<div class="next-previous--feedback__wrap">
<a href="https://bitcoindesign.slack.com/archives/C015856BDME">{% include slack.svg %} Ask a question</a>
<a href="https://discord.com/channels/903125802726596648/903126089512153088">{% include discord.svg %} Ask a question</a>
<a href="https://twitter.com/intent/tweet?url={{site.url}}{{page.url}}">{% include twitter.svg %} Share</a>
<a href="https://github.com/BitcoinDesign/Guide/discussions">{% include github.svg %} Discuss</a>
<a href="{{site.github_repository_url}}blob/master/{{page.path}}">{% include github.svg %} Edit page</a>
Expand Down
6 changes: 3 additions & 3 deletions _includes/social.html
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
<nav class="social-media-list">
<a
rel="me"
href="{{ site.slack_invite_url }}"
title="Bitcoin Design Slack"
href="{{ site.discord_invite_url }}"
title="Bitcoin Design Discord"
>
{% include slack.svg %}
{% include discord.svg %}
</a>
<a
rel="me"
Expand Down
6 changes: 3 additions & 3 deletions contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ If you are not familiar with the concepts of open design, we have a [great intro

## How to get involved in the community

1. [Join the community on Slack]({{ site.slack_invite_url }}) and say hi in the [#introductions](https://bitcoindesign.slack.com/archives/C0162PV1810) channnel
1. [Join the community on Discord]({{ site.discord_invite_url }}) and say hi in the [#introductions](https://discord.com/channels/903125802726596648/903126234232422411) channnel
1. [Subscribe to the newsletter]({{ '/newsletter/' | relative_url }}) and follow on [social media]({{ '/social-media' | relative_url }}), like [Twitter](https://twitter.com/bitcoin_design), to stay up-to-date
1. Subscribe and watch recordings of calls we organized on [BitcoinTV](https://bitcointv.com/a/bitcoin_design/videos) and [YouTube](https://www.youtube.com/c/BitcoinDesign/videos)
1. Read up on our [project life cycle](https://github.com/BitcoinDesign/Meta/blob/master/Projects.md)
Expand All @@ -43,7 +43,7 @@ If you are not familiar with the concepts of open design, we have a [great intro

1. See the projects we are either involved in or recommend on the [projects]({{ 'projects' | relative_url }}) page
1. Browse [issues labeled as collaborations](https://github.com/BitcoinDesign/Meta/issues?q=is%3Aopen+is%3Aissue+label%3Acollaboration)
2. Browse the various Slack channels to see what projects are being discussed and chime in. Open-source relies on pro-active contributions.
2. Browse the various Discord channels to see what projects are being discussed and chime in. Open-source relies on pro-active contributions.
1. Contribute to the [Bitcoin Design Guide]({{ '/guide/' | relative_url }})

## Bitcoin Design Guide
Expand All @@ -53,7 +53,7 @@ Our first community project is a free, open-source repository for anyone buildin
- [View the guide]({{ 'guide' | relative_url }})
- Follow progress on the [roadmap](https://github.com/orgs/BitcoinDesign/projects/2)
- We have a whole section on [how to contribute]({{ 'guide/contribute/' | relative_url }})
- Discuss on the [#bitcoin-design-guide](https://bitcoindesign.slack.com/archives/C015856BDME) Slack channel
- Discuss on the [#bitcoin-design-guide](https://discord.com/channels/903125802726596648/903126089512153088) Discord channel
- Join a [Design Guide Jam Session](https://github.com/BitcoinDesign/Meta/issues?q=is%3Aissue+is%3Aopen+%22jam+session%22+) where we discuss what is being worked on. We organize them every third Monday
- Review code and content on the [Github repository](https://github.com/BitcoinDesign/Guide)
- Read the original [project intro](https://docs.google.com/document/d/1YiYeRIybGmxmErCOI4Jc8Qajz3JGM1JYVfUtpzyCzSk/edit?usp=sharing) document
Expand Down
2 changes: 1 addition & 1 deletion guide/case-studies/blixt-wallet.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Illustration sources: https://www.figma.com/file/eyQDCaMoQvnRVcHzSsgrzs/Blixt-UX

## How do we help users new to lightning start using their wallet?

The [Bitcoin Design Community]({{ site.slack_invite_url }}) ran a design sprint on an open-source lightning wallet. During this sprint, we collaboratively focused on re-designing one aspect of the user flow, the **onboarding journey**. In this collaborative effort, [we got together](https://www.youtube.com/watch?v=nctibe_a4rM&list=PLpV0KfVOMojYywq1Blp3SGx62cSyoRfHt&index=3) as a group of designers and researchers, and aimed to improve the user experience using good design principles, and incorporating as much feedback from users as possible.
The [Bitcoin Design Community]({{ site.discord_invite_url }}) ran a design sprint on an open-source lightning wallet. During this sprint, we collaboratively focused on re-designing one aspect of the user flow, the **onboarding journey**. In this collaborative effort, [we got together](https://www.youtube.com/watch?v=nctibe_a4rM&list=PLpV0KfVOMojYywq1Blp3SGx62cSyoRfHt&index=3) as a group of designers and researchers, and aimed to improve the user experience using good design principles, and incorporating as much feedback from users as possible.

<p class="h3">Blixt Wallet is a non-custodial, open-source, bitcoin and lightning wallet for Android and iOS. It aims to serve users who are familiar with bitcoin, but new to lightning and want to try it out for the first time.</p>

Expand Down
4 changes: 2 additions & 2 deletions guide/contribute/contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,9 +60,9 @@ Join our open community and help us improve the Bitcoin Design Guide.

---

### [Slack channel]({{ site.slack_invite_url }})
### [Discord channel]({{ site.discord_invite_url }})

Head over to the [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.
Head over to the [Bitcoin Design Discord community]({{ site.discord_invite_url }}) and join the #bitcoin-design-guide channel. If you don’t have Discord, you can [download it here](https://discord.com/download) or on the App Store.


---
Expand Down
2 changes: 1 addition & 1 deletion guide/contribute/formatting/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ main_classes: -no-top-padding

This page showcases the various formatting and layout options available for content. Note that there is a [separate page]({{ '/guide/contribute/formatting/media/' | relative_url }}) for formatting images, videos, animations and prototypes. This allows editors to better understand their toolbox and access reference code. It also allows designers to see the design system in one place.

The design source file is a public Figma community file you can find [here](https://www.figma.com/community/file/862622015964353400/Bitcoin-Designers-site). To improve the design, please start with the Figma file and make a proposal in Slack or Github before implementing.
The design source file is a public Figma community file you can find [here](https://www.figma.com/community/file/862622015964353400/Bitcoin-Designers-site). To improve the design, please start with the Figma file and make a proposal in Discord or Github before implementing.

---

Expand Down
2 changes: 1 addition & 1 deletion guide/contribute/propose-a-change.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ If you're looking to help, but not sure where to begin:

- Check issues labeled as [Good first issue](https://github.com/BitcoinDesign/Guide/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
- Check issues labeled as [Design](https://github.com/BitcoinDesign/Guide/issues?q=is%3Aissue+is%3Aopen+label%3Adesign)
- Consult the community [on Slack]({{ site.slack_invite_url }}) or start a [GitHub discussion](https://github.com/BitcoinDesign/Guide/discussions/new) with your proposal
- Consult the community [on Discord]({{ site.discord_invite_url }}) or start a [GitHub discussion](https://github.com/BitcoinDesign/Guide/discussions/new) with your proposal
- Browse [bitcoin.design](https://bitcoin.design/guide) test it and try to identify issues yourself

For more challenging pieces of work, a new page, or a new chapter, it's a good idea to talk to the community and seek consensus before you begin working on it. This helps avoid work duplication and ensures your efforts are aligned with the community-determined goals.
Expand Down
2 changes: 1 addition & 1 deletion guide/designing-products/user-research.md
Original file line number Diff line number Diff line change
Expand Up @@ -206,7 +206,7 @@ Links to:

---

Join the discussion in the [#research channel](https://bitcoindesign.slack.com/archives/C015DQEPCHJ) on the Bitcoin Design Slack.
Join the discussion in the [#research channel](https://discord.com/channels/903125802726596648/903126614236360764) on the Bitcoin Design Discord.

<!--

Expand Down
2 changes: 1 addition & 1 deletion guide/getting-started/open-design.md
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,7 @@ Open-source software development has existed for decades. Public review and deba

**Our focus is on exploring best practices to improve bitcoin product design.**

- Join the conversation on [Slack]({{site.slack_invite_url}}). Navigate toward the channels that interest you. Dive into topics and conversations that draw you in.
- Join the conversation on [Discord]({{site.discord_invite_url}}). Navigate toward the channels that interest you. Dive into topics and conversations that draw you in.
- Identify your strengths and goals. Figure out how they may fit within the community's vision. A good place to start is listening to a [Community Call](https://github.com/BitcoinDesign/Meta/issues?q=is%3Aissue+is%3Aopen+Community+Call) or reading our [newsletter]({{ '/newsletter/' | relative_url }}).
- Feel free to ask questions or ask for help in solving bitcoin design issues.
- See some of the community [Projects](https://bitcoin.design/projects/).
Expand Down
2 changes: 1 addition & 1 deletion guide/resources/design-challenges.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ Bob Jr wants to receive his weekly allowance in bitcoin. Design a low-fidelity a

Bob wants to buy an engagement ring to surprise Alice. He has to pay on-chain because it's a large expense. Alice recently sent him sats, so she has a view into the sats in Bob's wallet. Design a low-fidelity flow Bob might follow to spend his sats using [PayJoin](https://en.bitcoin.it/wiki/PayJoin). In contrast to a naïve transaction, thanks to PayJoin, even if Alice sees the resulting transaction on-chain she won't be able to discern whether it is a small transfer, output consolidation, or the large purchase that would spoil the surprise.

[Get started with these design-oriented notes](https://docs.google.com/document/d/1y5qiKEX2WXMoDgdNclKcZ2RHDIM8wX5OkhREA-Hmc0k/edit?usp=sharing). For more details, check out the bitcoin design [call](https://bitcointv.com/w/3cZH5KVZwsxU6X9iNzDkBE), [FigJam File with in-call notes](https://www.figma.com/file/YC1rjRo3xYvkqJPL4vlg4r/Learning-Bitcoin-and-Design---PayJoins?node-id=0%3A1&t=I3u9Sbe7iMp6WbjV-1), mention this challenge in [slack]({{ site.slack_invite_url }}) or email d at ngould dot dev for help.
[Get started with these design-oriented notes](https://docs.google.com/document/d/1y5qiKEX2WXMoDgdNclKcZ2RHDIM8wX5OkhREA-Hmc0k/edit?usp=sharing). For more details, check out the bitcoin design [call](https://bitcointv.com/w/3cZH5KVZwsxU6X9iNzDkBE), [FigJam File with in-call notes](https://www.figma.com/file/YC1rjRo3xYvkqJPL4vlg4r/Learning-Bitcoin-and-Design---PayJoins?node-id=0%3A1&t=I3u9Sbe7iMp6WbjV-1), mention this challenge in [Discord]({{ site.discord_invite_url }}) or email d at ngould dot dev for help.

## Tips

Expand Down
2 changes: 1 addition & 1 deletion guide/resources/design-files.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ The right-hand panel has an “Inspect” tab that is a great companion for deve

## Community seal usage

Feel free to use and remix the seal. Before attaching it more formally to a project or initiative, be sure to ask the broader community. Not everyone might be OK with it. You can post in the [#general](https://bitcoindesign.slack.com/archives/C014J9ZKXB4) channel in Slack or open an issue in the [meta repo](https://github.com/BitcoinDesign/Meta/issues) on github.
Feel free to use and remix the seal. Before attaching it more formally to a project or initiative, be sure to ask the broader community. Not everyone might be OK with it. You can post in the [#general](https://discord.com/channels/903125802726596648/956386942788980766) channel in Discord or open an issue in the [meta repo](https://github.com/BitcoinDesign/Meta/issues) on github.

---

Expand Down
Loading