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

site showcase blogpost ready #5932

Merged
merged 11 commits into from
Jul 20, 2018
Merged
Show file tree
Hide file tree
Changes from 2 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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
111 changes: 111 additions & 0 deletions docs/blog/2018-06-15-why-we-built-the-site-showcase/index.md
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)

This comment was marked as resolved.


![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.


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.


## 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.

This comment was marked as resolved.


![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.

Copy link
Contributor

Choose a reason for hiding this comment

The 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.

- [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.

* 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.

Copy link
Contributor Author

Choose a reason for hiding this comment

The 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.

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.

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.

- [ ] 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).






Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.