Skip to content

Commit

Permalink
fix(docs): fix 404 links (#19853)
Browse files Browse the repository at this point in the history
* fix link in adding-react-components.md

* fix link to twitter gill kyle

* remove link to not existing GIPHY

* changed twitter handle ( https://www.katiefujihara.com/ )

* removed non existing user at twitter @fernandopoumian - can not find a new one :(

* fix wrong link to react-rehydration -> react-hyadration

* reactfaq.site is abandoned ( timarney/react-faq#39 )

* fixed link for gatsby-starter-theme-workspace

* fixed link for gatsby-theme-blog and gatsby-theme-notes

* fixed link for rfcs 0004-native-graphql-source

* fixed link for octoverse.github.com/#top-languages

* fixed link for gatsby-theme-apollo-docs project-config-panel.mdx

* fixed link for github.com/nicholaswyoung


Co-authored-by: Muescha <>
  • Loading branch information
muescha authored and LekoArts committed Nov 28, 2019
1 parent e10adc6 commit 7b814f8
Show file tree
Hide file tree
Showing 14 changed files with 14 additions and 17 deletions.
2 changes: 1 addition & 1 deletion docs/blog/2017-09-26-embracing-graphql/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ excerpt: "Moving to Gatsby 1.x and embracing the new GraphQL setup can be daunti
tags: ["v1", "graphql", "getting-started"]
---

Before I built [React FAQ](https://reactfaq.site/), I went looking for a static
Before I built "React FAQ" (GitHub: https://github.com/timarney/react-faq), I went looking for a static
site generator.

I had a few criteria in mind.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -133,8 +133,6 @@ nothing and end up with an infinitely more secure, scalable and faster website.

Say what?

<div style="width:100%;height:0;padding-bottom:75%;position:relative;"><iframe src="https://giphy.com/embed/xT0xeqCPRLHBUvWa88" width="100%" height="100%" style="position:absolute" frameBorder="0" class="giphy-embed" allowFullScreen></iframe></div><p><a href="https://giphy.com/gifs/way-orange-better-xT0xeqCPRLHBUvWa88">via GIPHY</a></p>

## Enter the world of static site generators...

If you are a developer, you probably are familiar with Static Site Generators,
Expand Down
2 changes: 1 addition & 1 deletion docs/blog/2017-12-07-taking-gatsby-for-a-spin/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ export const query = graphql`

After reading some articles on the Gatsby site, I decided to set up my Gatsby hosting on a free plan from [Netlify](https://www.netlify.com/) (which is ridiculously generous by the way, what's the catch?) and that has been a fun experience. Netlify already supports Gatsby out of the box, which means you can configure automatic deploys with `git` in a few clicks. Every time I push to master, the site gets rebuild and uploaded by Netlify. _Magic_. There's also the possibility to configure staging servers based on your branches, so you can always test out your changes before merging to master and deploying.

But wait, there's more. If you use [Contentful](https://www.contentful.com/) as Content Management System and Netlify as your host, you can easily create a Webhook to trigger a rebuild on every content update! I haven't tried this myself yet, but [this posts](https://www.halfelectronic.com/post/setting-up-gatsby-js-contentful-and-netlify/) by [Fernando Poumián](https://twitter.com/fernandopoumian) is a great resource to get you going.
But wait, there's more. If you use [Contentful](https://www.contentful.com/) as Content Management System and Netlify as your host, you can easily create a Webhook to trigger a rebuild on every content update! I haven't tried this myself yet, but [this posts](https://www.halfelectronic.com/post/setting-up-gatsby-js-contentful-and-netlify/) by Fernando Poumián is a great resource to get you going.

Incremental builds aren't yet possible, so every update means a complete rebuild. I'm sure that's no cause for concern on smaller sites, but with larger sites that are updated often it could be a problem. Luckily, incremental builds will be part of Gatsby ['sooner than later'](https://twitter.com/gatsbyjs/status/937053640652611584), which will take care of that problem.

Expand Down
2 changes: 1 addition & 1 deletion docs/blog/2018-09-17-gatsby-v2.md
Original file line number Diff line number Diff line change
Expand Up @@ -125,7 +125,7 @@ We've added experimental support for GraphQL stitching.

More and more services offer native GraphQL APIs and GraphQL stitching lets you use their API directly in your Gatsby site without having to wrap the API with a source plugin.

- [Read the RFC](https://github.com/gatsbyjs/rfcs/blob/master/text/0000-native-graphql-source.md)
- [Read the RFC](https://github.com/gatsbyjs/rfcs/blob/master/text/0004-native-graphql-source.md)
- [Try out the plugin gatsby-source-graphql](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-graphql/README.md)

### Ludicrous Mode (aka faster data hot reloading)
Expand Down
2 changes: 1 addition & 1 deletion docs/blog/2018-10-15-beyond-static-intro/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ One of the central ideas of Gatsby is that we statically generate our HTML conte
1. Invoke [ReactDOM.hydrate method][hydrate] to pick up just where we left our static HTML
1. Transfer rendering to the [React reconciler][reconciler]

_This process is spelled out in more detail in the ["Understanding React Rehydration" guide](/docs/react-rehydration)_
_This process is spelled out in more detail in the ["Understanding React Hydration" guide](/docs/react-hydration)_

It's this last phase that bridges the gap between static sites and full-fledged applications. In this phase you can make data calls, authenticate users, and perform all the app-like functionality you desire.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -324,4 +324,4 @@ If you run into an error that your theme plugin can't be found, try clearing you

to your _package.json_ file. Then you can use `npm run clean` in your terminal.

If you happen to find this tutorial helpful, please feel free to let me know on Twitter [@KatieofCode](https://www.twitter.com/katieofcode)! I would love to see what kind of themes you build.
If you happen to find this tutorial helpful, please feel free to let me know on Twitter [@KatieFujihara](https://www.twitter.com/KatieFujihara)! I would love to see what kind of themes you build.
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ Enterprise users seeking a quick way to limit their TCO may look to hosting prod

One of the most common complaints I hear from enterprise users of CMSs is the paucity of available affordable developers to build out the digital architecture of their dreams. While there has always been downward pressure on the number of available Adobe and Sitecore developers due to their proprietary nature, the decline in the prevalence of Drupal and WordPress developers has reflected a larger trend.

JavaScript is quickly winning out as the only language that can operate shared code across both client and server (in a paradigm known as [_universal_ or _isomorphic_ JavaScript](https://dri.es/a-history-of-javascript-across-the-stack)), and it has seen incredible growth in the web development community. In every year since 2014, JavaScript and Java have edged out other programming languages as the [most commonly used on GitHub](https://octoverse.github.com/projects#languages). Meanwhile, PHP fell from third to fourth, and other previously popular languages like Ruby are seeing even steeper declines.
JavaScript is quickly winning out as the only language that can operate shared code across both client and server (in a paradigm known as [_universal_ or _isomorphic_ JavaScript](https://dri.es/a-history-of-javascript-across-the-stack)), and it has seen incredible growth in the web development community. In every year since 2014, JavaScript and Java have edged out other programming languages as the [most commonly used on GitHub](https://octoverse.github.com/#top-languages). Meanwhile, PHP fell from third to fourth, and other previously popular languages like Ruby are seeing even steeper declines.

As university programs and coding bootcamps continue to swap previously intermixed curricula with JavaScript-only pedagogies, JavaScript adoption has continued to widen. In Stack Overflow’s yearly Developer Survey, JavaScript has posted increases every year since 2016, when it was [voted most popular language](https://insights.stackoverflow.com/survey/2016#technology-most-popular-technologies) by 55.4% of respondents. In 2019, [that percentage was 67.8%](https://insights.stackoverflow.com/survey/2019#most-popular-technologies). While these data only paint part of the picture, it is clear that JavaScript has emerged as the runaway victor when it comes to languages that cross the server–client divide.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ Using [MDX](/docs/mdx/), we’re able to write rich documentation by including R

![Enhanced code blocks](./images/code-blocks.gif)

Lastly, MDX introduces the concept of composing pages from shared chunks of content. For example, we may want to document some commonly used steps to set up an Apollo project. Instead of copying and pasting that content into multiple pages, we can write it once as [an MDX file](https://github.com/apollographql/gatsby-theme-apollo/blob/master/packages/gatsby-theme-apollo-docs/mdx/project-config-panel.mdx), import it into other MDX files, and [render it like a React component](https://www.apollographql.com/docs/platform/schema-validation/#set-up-schema-validation). What’s more? Since we’re working with MDX, we can use interactive React elements within the shared content!
Lastly, MDX introduces the concept of composing pages from shared chunks of content. For example, we may want to document some commonly used steps to set up an Apollo project. Instead of copying and pasting that content into multiple pages, we can write it once as [an MDX file](https://github.com/apollographql/gatsby-theme-apollo/blob/master/packages/gatsby-theme-apollo-docs/shared/project-config-panel.mdx), import it into other MDX files, and [render it like a React component](https://www.apollographql.com/docs/platform/schema-validation/#set-up-schema-validation). What’s more? Since we’re working with MDX, we can use interactive React elements within the shared content!

![Creating shared content in MDX](./images/shared-content.png)

Expand Down
4 changes: 2 additions & 2 deletions docs/blog/2019-07-15-theme-jam-contest/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,11 @@ To celebrate the [stable release of Gatsby Themes](/blog/2019-07-03-announcing-s

Gatsby Themes are pre-built, installable packages for setting up a site’s default styling, components, plugins, and overall configuration that can be reused across multiple Gatsby sites. They’re a great way to simplify the early steps of configuring a new site; and, when it’s time to update your site’s styling or functionality, you only have to edit your theme or swap it out entirely with another compatible theme. You can find a more detailed explanation in the [Themes section of Gatsby’s documentation](/docs/themes/).

If you’d like to see an example, check out Gatsby’s official [blog theme](https://github.com/gatsbyjs/gatsby/tree/master/themes/gatsby-theme-blog) or [notes theme](https://github.com/gatsbyjs/gatsby/tree/master/themes/gatsby-theme-notes).
If you’d like to see an example, check out Gatsby’s official [blog theme](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-theme-blog) or [notes theme](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-theme-notes).

## How to build your Gatsby theme

If you’re planning to build a theme for the contest, you may want to start with this [Gatsby Theme Jam Submission Example repository](https://github.com/jlengstorf/gatsby-theme-jam-example). You can build a child theme of an existing Gatsby theme (e.g. the [blog theme](https://github.com/gatsbyjs/gatsby/tree/master/themes/gatsby-theme-blog) or [notes theme](https://github.com/gatsbyjs/gatsby/tree/master/themes/gatsby-theme-notes)) with updated styling or added functionality, for example, or it can be a completely new theme.
If you’re planning to build a theme for the contest, you may want to start with this [Gatsby Theme Jam Submission Example repository](https://github.com/jlengstorf/gatsby-theme-jam-example). You can build a child theme of an existing Gatsby theme (e.g. the [blog theme](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-theme-blog) or [notes theme](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-theme-notes)) with updated styling or added functionality, for example, or it can be a completely new theme.

Here are some resources with detailed instructions on how to build a Gatsby theme:

Expand Down
2 changes: 1 addition & 1 deletion docs/blog/2019-08-07-theme-jam/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ Of the 111 submissions, 52 passed the automated review.

### Part 2: Manual Review

Every theme that cleared the automated review was manually reviewed by [Jackson](https://twitter.com/jxnblk), [Amberley](https://twitter.com/amber1ey), [John](https://twitter.com/4lpine), [Kyle Gill](https://gill_kyle), [Chris](https://twitter.com/chrisbiscardi), [Flo](https://twitter.com/fk), and [me](https://twitter.com/jlengstorf).
Every theme that cleared the automated review was manually reviewed by [Jackson](https://twitter.com/jxnblk), [Amberley](https://twitter.com/amber1ey), [John](https://twitter.com/4lpine), [Kyle Gill](https://twitter.com/gill_kyle), [Chris](https://twitter.com/chrisbiscardi), [Flo](https://twitter.com/fk), and [me](https://twitter.com/jlengstorf).

Amberley did a manual accessibility audit. Nearly all of the themes we reviewed have a few accessibility issues, so we will be opening issues with feedback and suggestions to improve that.

Expand Down
3 changes: 1 addition & 2 deletions docs/blog/author.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,6 @@
- id: Fernando Poumian
bio: Full-Stack Web Developer - https://www.halfelectronic.com
avatar: avatars/fernando-poumian.jpeg
twitter: "@fernandopoumian"
- id: Josh Weaver
bio: Developer at By the Book, Inc. Enjoys technology, writing and playing music. Can't turn down a decent board game.
avatar: avatars/josh-weaver.jpg
Expand Down Expand Up @@ -245,7 +244,7 @@
- id: Katie Fujihara
bio: Lover of making beautiful UI. Portland tech community organizer.
avatar: avatars/katie-fujihara.jpg
twitter: "@katieofcode"
twitter: "@KatieFujihara"
- id: Sidhartha Chatterjee
bio: Core team @ GatsbyJS. Full-Stack Developer. Scuba diver.
avatar: avatars/sidhartha-chatterjee.jpg
Expand Down
2 changes: 1 addition & 1 deletion docs/blog/gatsby-first-beta-release.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ individuals and companies.
- [Jason Quense](https://github.com/jquense)
- [Fabien Bernard](https://github.com/fabien0102)
- [Scotty Eckenthal](https://github.com/scottyeck)
- [Nicholas Young](https://github.com/nicholaswyoung)
- [Nicholas Young](https://github.com/secretfader)
- [Florian Kissling](https://github.com/fk)
- [Jacob Bolda](https://github.com/jbolda)
- [Noah Lange](https://github.com/noahlange)
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/adding-react-components.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ To learn more about solutions for supporting SSR and client-side libraries, chec

Some packages expect `window` or another browser global to be defined. These packages will have to be patched.

You can learn how to patch these packages on the [Debugging HTML Builds documentation](docs/debugging-html-builds/#fixing-third-party-modules).
You can learn how to patch these packages on the [Debugging HTML Builds documentation](/docs/debugging-html-builds/#fixing-third-party-modules).

### Components without server-side rendering

Expand Down
2 changes: 1 addition & 1 deletion docs/tutorial/building-a-theme.md
Original file line number Diff line number Diff line change
Expand Up @@ -1546,7 +1546,7 @@ Congratulations! You've set up, built, and customized your first Gatsby theme!
### Further reading

- Check out the [Gatsby themes docs](/docs/themes/) to keep learning.
- Have an idea for a theme you'd like to build? Get a headstart on a local theme development workspace using the [Theme Workspace starter](https://github.com/gatsbyjs/gatsby/tree/master/themes/gatsby-starter-theme-workspace).
- Have an idea for a theme you'd like to build? Get a headstart on a local theme development workspace using the [Theme Workspace starter](https://github.com/gatsbyjs/gatsby/tree/master/starters/gatsby-starter-theme-workspace).
- Have you built a Gatsby starter before? Perhaps [convert that starter to a theme](/docs/themes/converting-a-starter).

### Livestreams
Expand Down

0 comments on commit 7b814f8

Please sign in to comment.