Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fixed or deleted dead links in docs/design-and-ux #13182

Merged
merged 5 commits into from
Jul 10, 2024

Conversation

jacobjelen
Copy link
Contributor

Description

  • Dead links removed or fixed
  • Added a link to Web3 UX Design Handbook as a useful resource, which includes 2 previously linked articles

Related Issue

@github-actions github-actions bot added the content 🖋️ This involves copy additions or edits label Jun 17, 2024
Copy link

netlify bot commented Jun 17, 2024

Deploy Preview for ethereumorg ready!

Name Link
🔨 Latest commit 40bb967
🔍 Latest deploy log https://app.netlify.com/sites/ethereumorg/deploys/667a05714d7737000888057f
😎 Deploy Preview https://deploy-preview-13182--ethereumorg.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
7 paths audited
Performance: 47 (no change from production)
Accessibility: 92 (no change from production)
Best Practices: 89 (🔴 down 3 from production)
SEO: 93 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify site configuration.

@corwintines corwintines self-assigned this Jun 24, 2024
Copy link
Member

@wackerow wackerow left a comment

Choose a reason for hiding this comment

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

@jacobjelen Left one question, otherwise this looks good!

- [Web3 Design Patterns](https://www.web3designpatterns.io/)- A curated library of design patterns from real Web3 products
- [W3design.io](https://w3design.io/) - A curated library of UI flows of different projects in the ecosystem
- [Neueux.com](https://neueux.com/apps) - UI library of user flows with diverse filtering options
- [Web3's Usability Crisis: What You NEED to Know!](https://www.youtube.com/watch?v=oBSXT_6YDzg) - A panel discussion on pitfalls of developer focused project building (video, 34 min)

## Web3 Design Case Studies {#design-case-studies}

- [How to write better web3 error messages](https://medium.com/@JonCrabb/how-to-design-better-web3-error-messages-bd96e12fa582)
- [Defi design tips](https://medium.com/@JonCrabb/defi-design-tips-vol-12-8600f4374714)
Copy link
Member

Choose a reason for hiding this comment

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

This resource still looks reasonable at a glance. Was there a reason for removing it?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Same as my reason above. Article by Jon Crabb, who created https://web3ux.design/ which I have added. Same content, better structured, public website

Copy link
Member

@corwintines corwintines left a comment

Choose a reason for hiding this comment

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

Thanks @jacobjelen.

Have a few questions around the articles being removed, but the ones being added all look good to me.

- [Web3 Design Principles](https://medium.com/@lyricalpolymath/web3-design-principles-f21db2f240c1) - A framework of UX rules for blockchain based dapps
- [Blockchain Design Principles](https://medium.com/design-ibm/blockchain-design-principles-599c5c067b6e) - Lessons learned by the blockchain design team at IBM
- [Dimensions of web3 UX](https://uxdesign.cc/the-levels-of-web3-user-experience-4f2ad113e37d) - An analysis of different layers of web3 UX and its challenges
Copy link
Member

Choose a reason for hiding this comment

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

This article is still available. Is the reason for removal because of needing to be a member to access this?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This, and the other links I have removed are all by Jon Crabb. Since publishing them, he's created https://web3ux.design/. Where he compiled all these articles, and much more, into a well structured and public website. I think it's better to link to it, rather than 3 separate links individual articles.

- [Web3 Design Patterns](https://www.web3designpatterns.io/)- A curated library of design patterns from real Web3 products
- [W3design.io](https://w3design.io/) - A curated library of UI flows of different projects in the ecosystem
- [Neueux.com](https://neueux.com/apps) - UI library of user flows with diverse filtering options
- [Web3's Usability Crisis: What You NEED to Know!](https://www.youtube.com/watch?v=oBSXT_6YDzg) - A panel discussion on pitfalls of developer focused project building (video, 34 min)

## Web3 Design Case Studies {#design-case-studies}

- [How to write better web3 error messages](https://medium.com/@JonCrabb/how-to-design-better-web3-error-messages-bd96e12fa582)
Copy link
Member

Choose a reason for hiding this comment

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

This article is still available. Is the reason for removal because of needing to be a member to access this?

Copy link
Member

Choose a reason for hiding this comment

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

I assumed as such... on the note of UX, best imo if we link to article the user can read immediately

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Same as my reason above. Article by Jon Crabb, who created https://web3ux.design/ which I have added. Same content, better structured, public website

- [Web3 Design Patterns](https://www.web3designpatterns.io/)- A curated library of design patterns from real Web3 products
- [W3design.io](https://w3design.io/) - A curated library of UI flows of different projects in the ecosystem
- [Neueux.com](https://neueux.com/apps) - UI library of user flows with diverse filtering options
- [Web3's Usability Crisis: What You NEED to Know!](https://www.youtube.com/watch?v=oBSXT_6YDzg) - A panel discussion on pitfalls of developer focused project building (video, 34 min)

## Web3 Design Case Studies {#design-case-studies}

- [How to write better web3 error messages](https://medium.com/@JonCrabb/how-to-design-better-web3-error-messages-bd96e12fa582)
- [Defi design tips](https://medium.com/@JonCrabb/defi-design-tips-vol-12-8600f4374714)
Copy link
Member

Choose a reason for hiding this comment

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

This article is still available and doesn't require member access. I don't know that this needs removed unless theres another reason for this.

@@ -73,8 +69,7 @@ Get involved in professional community-driven organizations or join design group
- [Deepwork.studio](https://www.deepwork.studio/)
- [Designer-dao.xyz](https://www.designer-dao.xyz/)
- [We3.co](https://we3.co/)
- [Openux.xyz](https://openux.xyz/about)
- [web3trends.org](https://web3trends.org/)
- [Openux.xyz](https://openux.xyz/)
Copy link
Member

Choose a reason for hiding this comment

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

Unsure what to do here. New site is supposed to be out in the summer, but at the moment this isnt accessible for anything. Think we can probably still leave it, but wondering what others think here.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It's a working link, so I figured it can stay there. I just removed the /about

@corwintines
Copy link
Member

Just a bump @jacobjelen on above comments

@jacobjelen
Copy link
Contributor Author

jacobjelen commented Jul 4, 2024

@corwintines my comments from last week are still 'pending'. can you see them?

The working links I have removed are all by Jon Crabb. Since publishing them, he's created https://web3ux.design/. On there, he compiled all these articles, and much more, into a well structured and public website. I think it's better to link to it, rather than 3 separate links individual articles.

Copy link
Member

@corwintines corwintines left a comment

Choose a reason for hiding this comment

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

Thanks @jacobjelen!

@corwintines corwintines merged commit 288ba62 into ethereum:dev Jul 10, 2024
6 checks passed
This was referenced Jul 10, 2024
@konopkja
Copy link
Contributor

Hello, I think this is not a good change because we are removing links to specific articles in favor of generic page.

This hinders discoverability of those specific topics that are quite important. We can of course add link to Jon's curated handbook, but i think the specific articles should remain.

@jacobjelen
Copy link
Contributor Author

@konopkja IMHO it would be at least worth considering which specific articles from the handbook should be linked directly. 'Writing better error messages' seems very niche to be there. In the handbook it's just one extra click away.

Perhaps expanding the description of the handbook for the discoverability?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
content 🖋️ This involves copy additions or edits
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants