Skip to content

Update getting-started.md - #221

Closed
pavlenex wants to merge 8 commits into
BitcoinDesign:masterfrom
pavlenex:kenedits-1
Closed

pavlenex wants to merge 8 commits into
BitcoinDesign:masterfrom
pavlenex:kenedits-1

Conversation

@pavlenex

@pavlenex pavlenex commented Apr 12, 2021 •

Copy link
Copy Markdown
Contributor

Co-Authored-By: @sqcken
As explained in #220
Please review & merge after #220
Part of #202

BEFORE THE PR

Screenshot 2021-04-12 at 20 06 26
Screenshot 2021-04-12 at 20 06 42

AFTER THE PR

Screenshot 2021-04-12 at 20 12 49
Screenshot 2021-04-12 at 20 13 21

pavlenex and others added 4 commits April 12, 2021 20:01
Co-Authored-By: sqcken <70726704+sqcken@users.noreply.github.com>
Co-Authored-By: sqcken <70726704+sqcken@users.noreply.github.com>
Co-Authored-By: sqcken <70726704+sqcken@users.noreply.github.com>
Co-Authored-By: sqcken <70726704+sqcken@users.noreply.github.com>
@pavlenex
pavlenex requested a review from GBKS April 12, 2021 18:15
@GBKS GBKS added the Copy Task is about improving text. label Apr 14, 2021
@pavlenex

Copy link
Copy Markdown
Contributor Author

@GBKS Review beg, when you get the time 🙏

### [Why Bitcoin is unique]({{ '/guide/getting-started/why-bitcoin-is-unique/' | relative_url }})

The internet has opened an infinite design space for information and communication. Bitcoin adds the new dimension of transferring value that could bring similar change as previous waves of innovation.
Familiarize yourself with some of the most significant concepts that bitcoin designers need to know.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I preferred the original text, as it already gave a brief summary of the content. The updated text only teases but doesn't provide any real information.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Reverted in 7aaf56e

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I think there’s an issue with the original where it’s not immediately clear what the copy is actually describing. I think it could be read as grandiose.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@sqcken will re-open this once we get a clear picture on what stuff are actually describing. Will re-open when we're done with ironing out other pages.

### [Why design for Bitcoin]({{ '/guide/getting-started/why-design-for-bitcoin/' | relative_url }})

Bitcoin is fundamentally open and participatory and allows designers and creators to explore and shape experiences for users around the globe.
Bitcoin is open-source, decentralized, permissionless, fungible, stateless, and non-custodial. If those words don’t mean anything to you, consider starting here.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

The page is not about explaining those terms (we have the principles page for that), but why those properties make designing for Bitcoin exciting - why the reader should drop everything they are doing and start designing Bitcoin stuff. So to me, the new summary doesn't capture the page intent/content well.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Reverted in 7aaf56e

### [Open design]({{ '/guide/getting-started/open-design/' | relative_url }})

Open design is about global collaboration that balances the free exchange of design information, the independence of individual designers and the collective power of collaboration.
Bitcoin isn’t just changing money—it’s changing how designers collaborate across broad use cases. While open-source development has been around for years, open design is brand new.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Open design is not a result of Bitcoin. Maybe better to say that collaboration around Bitcoin products requires an open-design approach because Bitcoin itself is open-source based?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Attempt to balance things out in 7aaf56e please check

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I think that’s fine.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM with just minor tweaks: Bitcoin is an open-source protocol. The design process around it should be based on principles of openness and the collective power of collaboration. There's a an missing, and open-principles reads funny.

### [Personal finance]({{ '/guide/getting-started/personal-finance/' | relative_url }})

If we consider Bitcoin money, we need to consider how Bitcoin users think about their finances. This page provides a simple framework that can serve as a starting point, deriving bitcoin software and hardware setups from common budgeting categories.
The language of bitcoin is the language of money. If you’re still new to the concepts that underpin personal finance, this section can get you up to speed.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Also misses the point a little. It's not just about personal finance, but how Bitcoin products can be used to address those different personal finance needs.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Need a concrete suggestion here.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Just keep the original text?

### [Common user flows]({{ '/guide/getting-started/common-user-flows/' | relative_url }})

Most Bitcoin applications share certain user activities, from initial setup to making a transaction. It is vital to follow users' expected patterns and behaviors to reduce mistakes and enable seamless switching between products.
Because solutions to common problems such as how to send, store, and purchase bitcoin are often the most in demand, they are also the most available as a resource online.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Most in demand by whom? Also not sure what is meant by they are also the most available as a resource online?

Goal of this page is to provide a designer an overview of everything that can happen in a Bitcoin application. Some of those activities are totally not obvious and may take a lot of time to identify on your own. So it's a bit of a cheat sheet that should allow designers to make better decisions because they have a good idea of all user flows that need to be considered. Especially useful when considering navigation hierarchy.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Reverted 6a0b33b

@pavlenex pavlenex closed this Apr 26, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Copy Task is about improving text.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants