(Ready for merge) Adds showcase segment for starters/websites built with Gatsby. #1535

Vagr9K · 2017-07-17T20:25:59Z

Since, presumably, most people will be browsing github/npm readmes first, I have decided to include the "Showcase" segment in README.md.

Also, in contrary to the v0 showcase, this one also will include general features of starters listed under their bullet points. That will make finding implementations of different features (tags/categories/GA) easier.

I'm working on the website list right now. Unfortunately it seems like there are only 4 v1 starters available currently.

I'll make sure this will be ready for merging tomorrow.

KyleAMathews · 2017-07-17T20:26:32Z

Deploy preview failed.

Built with commit 0ac2c8c

https://app.netlify.com/sites/using-styled-components/deploys/596d5d567960b146c1477b27

KyleAMathews · 2017-07-17T20:33:01Z

Deploy preview failed.

Built with commit d827758

https://app.netlify.com/sites/image-processing/deploys/596d1d59424ef201f3fb9ce5

gatsbybot · 2017-07-17T20:35:00Z

Deploy preview ready!

Built with commit d44d785

https://deploy-preview-1535--using-drupal.netlify.com

gatsbybot · 2017-07-17T20:35:08Z

Deploy preview ready!

Built with commit d44d785

https://deploy-preview-1535--gatsbyjs.netlify.com

gatsbybot · 2017-07-17T20:41:38Z

Deploy preview ready!

Built with commit d44d785

https://deploy-preview-1535--gatsbygram.netlify.com

KyleAMathews · 2017-07-17T22:13:33Z

Let's not put the starters on the GitHub README. Perhaps mention there that starters exist and link to the website page for starters but let's focus the GitHub README on marketing and push people to the website for actual documentation.

We should have a curated list of impressive Gatsby websites there for marketing however.

Vagr9K · 2017-07-17T22:23:39Z

Maybe a separate page in the docs for starters?

We should have a curated list of impressive Gatsby websites there for marketing however.

And another one on gatsbyjs.org for websites? Or this one can go into README for marketing?

I'll create the list for now, and then actually append them to pages based on your feedback.

Vagr9K · 2017-07-18T09:08:40Z

@KyleAMathews I've separated starters into a different page in the documents. Should I do the same for websites?

KyleAMathews

Looking good!

KyleAMathews · 2017-07-18T19:20:37Z

README.md

+* [Segment's Blog](https://segment.com/blog/)
+* [Fabric](https://meetfabric.com/)
+* [Formidable](https://formidable.com/)
+* [ResonML Docs](https://reasonml.github.io/) [(source)](https://github.com/reasonml/reasonml.github.io)


KyleAMathews · 2017-07-18T19:21:29Z

README.md

+* [ResonML Docs](https://reasonml.github.io/) [(source)](https://github.com/reasonml/reasonml.github.io)
+* [Jamie Henson's Blog](http://jamiehenson.com/) [(source)](https://github.com/jamiehenson/jh47-gatsby)
+* [Sean Coker's Blog](https://sean.is/)
+* [Dustin Schau's Blog](https://dustinschau.com/blog/) [(source)](https://github.com/dschau/blog)


Add meetfabric.com as well

meetfabric.com is there. Maybe you mean sources?

Oh right, oops missed it.

KyleAMathews · 2017-07-18T19:24:21Z

docs/docs/gatsby-starters.md

+gatsby new https://github.com/gatsbyjs/gatsby-starter-blog my-log
+```
+
+Currently available starters:


Kill this line. It's redundant because if a starter isn't here it isn't currently available ;-)

Good point...

KyleAMathews · 2017-07-18T19:25:56Z

docs/docs/gatsby-starters.md

+title: 'Gatsby Starters'
+---
+
+GatsbyJS starters are premade projects packed with features which can be used for accelerating development speed. They are also a great source for learning about implementations of different features.


Let's just use my old intro from the v0-README

https://github.com/gatsbyjs/gatsby/blob/master/v0-README.md#gatsby-starters

KyleAMathews · 2017-07-18T19:27:12Z

www/src/pages/docs/doc-links.yaml

@@ -6,6 +6,7 @@
    Querying with GraphQL*: /docs/querying-with-graphql/
    Gatsby Lifecycle APIs: /docs/gatsby-lifecycle-apis/
    Deploying: /docs/deploy-gatsby/
+    Gatsby Starters: /docs/gatsby-starters


Just make this "Starters". Also remove "Gatsby" from "Gatsby Lifecycle APIs". The Gatsby part is obvious in these.

KyleAMathews · 2017-07-18T19:31:07Z

www/src/pages/docs/index.js

@@ -44,6 +44,8 @@ class IndexRoute extends React.Component {
            testing your built site.
          </li>
        </ol>
+        <h2>Using a GatbsyJS starter</h2>
+        <p>You can also use one of the premade <Link to="/docs/gatsby-starters/">Gatsby starters</Link> to save time, or learn about the possible usages of Gatsby in production. Starters are also great examples of feature implementations!</p>


How about a little more streamlined text here:

<h2>Using other starters</h2> <p>Running <code>gatsby new</code> installs the default Gatsby starter. There are <Link to="/docs/gatsby-starters/">many other official and community starters</Link> you can use to kickstart building your Gatsby site.</p>

Vagr9K · 2017-07-18T23:13:15Z

All requested fixes are here.
Note: The last starter tries to solve the issue of starters being either way too opinionated about UI or too basic.
I also want it to become a good learning resource for the newcomers, so we can refer them to code samples that don't contain hundreds of lines of UI logic. Sorting out questions about GA/Tags/Categories/RSS/SEO/Semi-Dynamic content should be easier.

I hope there are no issues with me having 2 starters on this list?

KyleAMathews · 2017-07-18T23:28:24Z

Deploy preview failed.

Built with commit 365f949

https://app.netlify.com/sites/using-remark/deploys/596e95fe8ebdd9219050f379

KyleAMathews · 2017-07-18T23:40:24Z

issues with me having 2 starters on this list?

Eventually we'll move this to a searchable, faceted, paginated list where you could have 100 starters if you felt like it :-)

Vagr9K · 2017-07-18T23:45:01Z

Do you prefer merging this now or waiting a little bit more to gather more sites/starters?

KyleAMathews · 2017-07-19T00:02:45Z

Merging now. You/others can add starters as they're found/made. 10 little PRs / day are way better than 10 big PRs / week.

fk · 2017-07-19T00:10:08Z

@Vagr9K Nice PR and cool advanced starter! 👍 👍 👍
Three things I spotted:

There's Font Awesome in package.json, but you don't seem to use it?! :-P
The link to "Big Test" doesn't work. :-(
I saw that in the "Big Test" article you're using the markdown content from the markdown-here wiki that I also based https://using-remark.gatsbyjs.org/hello-world-kitchen-sink/ on. I had to modify that because some things weren't working, e. g. the "Unordered sub-list." in https://vagr9k.github.io/gatsby-advanced-starter/Big-Sample_Test/#lists (hm, that's actually the only thing I can spot now … it's been a while ;-)). Also that … ;-D.

fk · 2017-07-19T00:11:11Z

Oh, and somehow the two spaces necessary for some of the line breaks examples went missing (probably because your editor strips end of line whitespace, see #1441 (comment)).

KyleAMathews · 2017-07-19T00:11:36Z

Deploy preview failed.

Built with commit d44d785

https://app.netlify.com/sites/using-postcss-sass/deploys/596ea1b1cf321c731fb614f3

Vagr9K · 2017-07-19T00:36:32Z

@fk Thanks for spotting those issues :)
Should be fixed by now.
As for the unexpected line break issue, I already had plans to integrate MD linter into the project, but now It's extra high on my list of priorities...
Thanks again!

fk · 2017-07-19T00:40:55Z

@Vagr9K You're welcome, happy to help!

Vagr9K added 4 commits July 17, 2017 23:48

Adds the base changes to README.

3efa817

Adds reference to the showcase in the docs.

7271ba3

Adds details to readme showcase.

217b126

Readability fixes.

d827758

Vagr9K added 6 commits July 18, 2017 02:37

Adds recently updated bootstrap starter.

694f282

Adds websites to the list.

0ac2c8c

Updates.

a55fdce

Separates Gatsby Starters from README.

38105b7

Fixes typos, adds more details.

595d762

Readability improvements.

45ada80

Vagr9K added 2 commits July 18, 2017 20:47

Updates to website list.

7402c2a

Makes the disctinction between official/community starters better.

5d655d1

KyleAMathews reviewed Jul 18, 2017

View reviewed changes

Vagr9K added 2 commits July 19, 2017 00:09

Fixes.

29731ac

Adds Gatsby advanced starter.

365f949

Vagr9K changed the title ~~(WIP) Adds showcase segment for starters/websites built with Gatsby.~~ (Ready for merge) Adds showcase segment for starters/websites built with Gatsby. Jul 18, 2017

Merge branch 'master' into showcase

d44d785

KyleAMathews merged commit 6d589b3 into gatsbyjs:master Jul 19, 2017

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

(Ready for merge) Adds showcase segment for starters/websites built with Gatsby. #1535

(Ready for merge) Adds showcase segment for starters/websites built with Gatsby. #1535

Vagr9K commented Jul 17, 2017

KyleAMathews commented Jul 17, 2017 •

edited

KyleAMathews commented Jul 17, 2017

gatsbybot commented Jul 17, 2017 •

edited

gatsbybot commented Jul 17, 2017 •

edited

gatsbybot commented Jul 17, 2017 •

edited

KyleAMathews commented Jul 17, 2017

Vagr9K commented Jul 17, 2017

Vagr9K commented Jul 18, 2017

KyleAMathews left a comment

KyleAMathews Jul 18, 2017

KyleAMathews Jul 18, 2017

Vagr9K Jul 18, 2017

KyleAMathews Jul 18, 2017

KyleAMathews Jul 18, 2017

Vagr9K Jul 18, 2017

KyleAMathews Jul 18, 2017

KyleAMathews Jul 18, 2017

KyleAMathews Jul 18, 2017

Vagr9K commented Jul 18, 2017

KyleAMathews commented Jul 18, 2017

KyleAMathews commented Jul 18, 2017 •

edited

Vagr9K commented Jul 18, 2017

KyleAMathews commented Jul 19, 2017

fk commented Jul 19, 2017

fk commented Jul 19, 2017

KyleAMathews commented Jul 19, 2017

Vagr9K commented Jul 19, 2017

fk commented Jul 19, 2017

(Ready for merge) Adds showcase segment for starters/websites built with Gatsby. #1535

(Ready for merge) Adds showcase segment for starters/websites built with Gatsby. #1535

Conversation

Vagr9K commented Jul 17, 2017

KyleAMathews commented Jul 17, 2017 • edited

KyleAMathews commented Jul 17, 2017

gatsbybot commented Jul 17, 2017 • edited

gatsbybot commented Jul 17, 2017 • edited

gatsbybot commented Jul 17, 2017 • edited

KyleAMathews commented Jul 17, 2017

Vagr9K commented Jul 17, 2017

Vagr9K commented Jul 18, 2017

KyleAMathews left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Vagr9K commented Jul 18, 2017

KyleAMathews commented Jul 18, 2017

KyleAMathews commented Jul 18, 2017 • edited

Vagr9K commented Jul 18, 2017

KyleAMathews commented Jul 19, 2017

fk commented Jul 19, 2017

fk commented Jul 19, 2017

KyleAMathews commented Jul 19, 2017

Vagr9K commented Jul 19, 2017

fk commented Jul 19, 2017

KyleAMathews commented Jul 17, 2017 •

edited

gatsbybot commented Jul 17, 2017 •

edited

gatsbybot commented Jul 17, 2017 •

edited

gatsbybot commented Jul 17, 2017 •

edited

KyleAMathews commented Jul 18, 2017 •

edited