-
Notifications
You must be signed in to change notification settings - Fork 10.3k
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
site showcase blogpost ready #5932
Changes from 2 commits
b1828f2
3c503a1
c95fdfc
1e7ff15
df2b362
3b161e2
ab17b92
441c970
f9293b9
42c2303
c4d7413
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,111 @@ | ||
--- | ||
title: Why We Created the Site Showcase | ||
date: 2018-06-15 | ||
author: Shannon Soper | ||
tags: [""] | ||
--- | ||
|
||
We recently finished the first phase of the [Site Showcase](https://next.gatsbyjs.org/showcase/), which is a searchable, filterable library of sites built with Gatsby! | ||
|
||
![Featured Sites](featured-sites.png) | ||
|
||
![Filtered Sites](filtered-sites.png) | ||
|
||
## Submitting your site | ||
|
||
If you’d like to submit a site to the showcase, please follow the [instructions in this document](https://github.com/gatsbyjs/gatsby/blob/v2/docs/docs/site-showcase-submissions.md). | ||
|
||
# Why build a site showcase? | ||
This comment was marked as resolved.
Sorry, something went wrong. |
||
|
||
We built the showcase to make it easier for you to find the source code for Gatsby sites and easier to show off what Gatsby can do to potential clients / coworkers. | ||
This comment was marked as resolved.
Sorry, something went wrong. |
||
|
||
## Source code | ||
|
||
Many people learn how to build things by looking at src code for other sites. As you browse through the site showcase, look for the GitHub icon on each site’s detail page which links you to the source code (not all sites will have it): | ||
This comment was marked as resolved.
Sorry, something went wrong.
This comment was marked as resolved.
Sorry, something went wrong. |
||
|
||
![Site Showcase Source Code Available Icon](site-showcase-source-code.png) | ||
|
||
## Showing off what Gatsby can do | ||
|
||
The site showcase can help you pitch Gatsby to clients and coworkers as the best option for their next project. As they search the site showcase, it will provide a vision of what developers can accomplish with Gatsby. | ||
|
||
# UX research process | ||
|
||
Here’s where we discussed and built the site showcase if you'd like to go through the discussion that led to this project: | ||
* [Site Showcase Issue](https://github.com/gatsbyjs/gatsby/issues/4392) | ||
* [Site Showcase WIP PR](https://github.com/gatsbyjs/gatsby/pull/5524) | ||
|
||
## Empathy map | ||
|
||
Here’s a summary of what I learned from over 80 interviews with Gatsby users. This "empathy map" describes what kinds of pain points we're trying to solve with the site showcase. | ||
|
||
![Empathy Map Site Showcase](empathy-map-site-showcase.jpg) | ||
|
||
## User Flow | ||
|
||
The empathy map reflects how it took most people a lot of time browsing through the Awesome Gatsby list to find example sites and how many people share their sites through Twitter and there isn’t enough time or room for everyone to get retweeted by the @Gatsbyjs account. | ||
|
||
With the empathy map and the interviews as our guide, we created a list of jobs to be done and imagined the typical flow a user would take through the site showcase. We did this to make sure we planned both a sensible information architecture and the necessary functionality to meet user’s main needs. | ||
|
||
![User flow](user-flow-site-showcase.jpg) | ||
|
||
## Defining the MVP | ||
|
||
Here are the features that clearly needed to be included in the MVP; you'll notice that we checked all the boxes thanks to the hard work of many people! | ||
This comment was marked as resolved.
Sorry, something went wrong. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Is the list too long to call everyone out by name? If we can specifically give credit to folks, that's always best. |
||
|
||
Users should be able to: | ||
- [x] See screenshots of sites built with Gatsby (Landing page) | ||
- [x] See source code (Site detail page) | ||
- [x] Share sites by copying the URL | ||
- [x] Filter by category | ||
- [x] Search | ||
This comment was marked as resolved.
Sorry, something went wrong. |
||
- [x] Submit their own site to the showcase through yaml file (Shannon writes the instructions) | ||
- [x] See featured sites | ||
|
||
# Ways you can help | ||
|
||
## Next steps for the site showcase | ||
|
||
* If you created a site with Gatsby or know someone who did and would like it to appear in the site showcase, [follow these instructions to add it](https://github.com/gatsbyjs/gatsby/blob/v2/docs/docs/site-showcase-submissions.md). | ||
* If you see a site with no description and you know who built it, kindly remind them to update it! | ||
* If you’d like to help speed up the previous two suggestions by writing a script to contact people who have submitted their sites in the past, see [issue #5928](https://github.com/gatsbyjs/gatsby/issues/5928): Site showcase: add descriptions, creators, and dates added | ||
This comment was marked as resolved.
Sorry, something went wrong. |
||
* Help solve [issue #5929 | ||
](https://github.com/gatsbyjs/gatsby/issues/5929): Site showcase: screenshots are not rendering non-roman characters | ||
|
||
|
||
## Future iterations | ||
|
||
Here's what we'll work on next in [Issue #5927](https://github.com/gatsbyjs/gatsby/issues/5927). Feel free to tackle any part of this project and contribute to it or discuss new possibilities! | ||
This comment was marked as resolved.
Sorry, something went wrong. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. oh yeah good point. I meant we in the sense of the community, but I can see how it'd sound exclusive. |
||
|
||
*Phase 2* | ||
This comment was marked as resolved.
Sorry, something went wrong. |
||
Users ought to be able to: | ||
- [ ] Sort by date added (won't matter until ppl start submitting sites) | ||
- [ ] click on a category name from the modal to filter by that category | ||
- [ ] Share sites with a social media / URL copy button in a modal | ||
- [ ] visit a personal page for creators of sites (see all sites they have submitted) | ||
|
||
*Very cool, not necessary right away* | ||
This comment was marked as resolved.
Sorry, something went wrong. |
||
It'd be awesome if users could: | ||
- [ ] For non-developers, have a CTA where they can hire someone to build them a Gatsby site / ask for demo, etc. (could be on upper menu, in which case it would not belong to site showcase) | ||
- [ ] See case studies related to sites | ||
- [ ] See a list of the site's dependencies | ||
- [ ] Sort by date updated for sites with open src code | ||
This comment was marked as resolved.
Sorry, something went wrong. |
||
- [ ] See the performance of each site in action (GIFs, performance metrics, data on traffic improvement after the site switched to Gatsby,etc.) | ||
- [ ] See a list of all sites that use a particular plugin (this would be a change to the plugin library, probably) | ||
- [ ] Sign up to get notifications or updates when new sites are added (or just sign up for the newsletter?) | ||
- [ ] Be guided to the tutorials if they want to build sites like the ones they are seeing | ||
|
||
## Sneak peak into the next UX project | ||
|
||
Our next UX project is finishing up the starter showcase, which will look similar to the site showcase and also have a major functional difference: filter by dependency. Please contribute to these issues to help out! | ||
* [Starter Showcase Issue](https://github.com/gatsbyjs/gatsby/issues/5334) | ||
* [Starter Showcase WIP PR](https://github.com/gatsbyjs/gatsby/pull/5831) | ||
Again, many thanks to all the community members who have contributed to this research and to making Gatsby awesome. Stay tuned for updates on the site showcase and future Gatsby UX research projects! | ||
* [Contact me](https://twitter.com/shannonb_ux/status/938551014956732418) here if you have feedback that differs from or provides deeper insight into one of the pain points this article mentions. | ||
* Follow us on [Twitter](https://twitter.com/gatsbyjs). | ||
|
||
|
||
|
||
|
||
|
||
|
This comment was marked as resolved.
Sorry, something went wrong.