Skip to content

new GraphQL website blog post #1692

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

Merged
merged 19 commits into from
Jun 12, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
7158075
graphql website blog
dimaMachina Jun 8, 2024
f26a0c1
Merge branch 'source' into new-website-blog
dimaMachina Jun 8, 2024
2f64956
polish by Benjie suggestions
dimaMachina Jun 8, 2024
948f472
one more fix
dimaMachina Jun 8, 2024
a90a6ca
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina Jun 8, 2024
69e801a
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina Jun 8, 2024
d3bdc7a
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina Jun 8, 2024
c76c6f1
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina Jun 8, 2024
0aa22fa
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina Jun 8, 2024
f0de752
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina Jun 8, 2024
b7d2721
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina Jun 8, 2024
869d18b
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina Jun 8, 2024
6b94d14
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina Jun 8, 2024
db72766
apply little comma fix
dimaMachina Jun 8, 2024
13a13fb
optimized images
dimaMachina Jun 11, 2024
49c07ab
update date
dimaMachina Jun 11, 2024
dafc351
remove `bundle size` improve phrase since Idk how to properly calcula…
dimaMachina Jun 11, 2024
7637a63
add `and developer experience`
dimaMachina Jun 11, 2024
ef8cd98
remove section of `Better Bundle Size and First Load Time`
dimaMachina Jun 11, 2024
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
6 changes: 6 additions & 0 deletions public/images/next-image-export-optimizer-hashes.json
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,11 @@
"/graphql-cover-1_53228256677_o.f1214f00.jpg": "OVKx+JK+SA2wdzmUs3VN+eHR7Fk2CXhTLYdNIyNbehg=",
"/graphql-cover-2_53228256672_o.80b12e74.jpg": "eRqA89yK+I9hdGfjSlv7sIpExOhByCXKn7xY86Lt2yA=",
"/graphql-cover-3_53228256612_o.a5360272.jpg": "MDj38ijAhAyJTMvi0vNE7JVj+uXRXNLUhdSXtZvEMT4=",
"/graphql-org-v0.8990439d.gif": "UuHxSMb-yt4-+HxYB-VRMfNYIa1UaNWQeGwA3Nd+GfI=",
"/graphql-org-v1-learn-page.44ccd7df.png": "GsV1iA47a64oNe+IgjoFKEtcbBKTCqtm1+ZkoARjt+I=",
"/graphql-org-v1.599caf32.gif": "Tp9NHPBhI8WQy7qOonZH5OqlRqtNlAIKnUMi0KefaOE=",
"/graphql-org-v2-learn-page-dark.0eae8efc.png": "cQ+Nj-zFKjn17sZa-W4-ooA-7XYEeqtNRSam4XL2S0c=",
"/graphql-org-v2-learn-page-light.009ff55d.png": "5r1ZoMqy1LQsDD8UvQM1nJKHgGwWa8gnD0ydO+QKZlk=",
"/graphqlconf-202310_53229130641_o.0a9f57a8.jpg": "3JBA7zAJe2Jn7AjB0d90j9sZtuipi1MSlKVKvH5gPQs=",
"/graphqlconf-202311_53229130636_o.8575f45f.jpg": "T8ODamSOqwJPcgfDqiOfpGMP-QFzKVh+KK96I2gttrI=",
"/graphqlconf-202312_53229431468_o.ae2d4d8c.jpg": "LNLPj3ut3nP++OsunMSjs9VMMSFJhG-m42Y5KKiO6RE=",
Expand Down Expand Up @@ -139,6 +144,7 @@
"/pinterest.36b58187.png": "TlwGD0W-rRqoDgDND5x+cQrzz09xU+dmW6oP8+qSBug=",
"/playground-transition-banner.2458871d.png": "ffm4o7utOWkmwaWC2KVVHPOz9zsaD6fG2P269pHT8uQ=",
"/rest-api-people.c2b56e20.png": "KDbPJA1rAhVT43LeGLckdesx+bISV+6g0q9fJQNl5Tg=",
"/sf-city-view.d5d36dff.jpeg": "a-QVXW74jpiDFhmUOc9hZY10pGvmpSLSdM+u0EcuRac=",
"/shopify.2cb330ea.png": "LRiC9+uEG-gHl-XYi4qrSXMAlpFglZLNZj1kBGF-Cag=",
"/uri.387cb001.jpg": "kSx4huEjQidwIg6bF8UEWLiPACDl0nQ0aqxA2R2LIe0=",
"/whiteboard.60eac8e3.jpg": "NodBqUaO+IanhuPaP9o5jCIe+gSrwyZ9TZ3QUdlWbBg="
Expand Down
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
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.
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.
119 changes: 119 additions & 0 deletions src/pages/blog/2024-06-11-announcing-new-graphql-website/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,119 @@
---
title: Announcing New GraphQL Website
tags: [announcements]
date: 2024-06-11
byline: Dimitri Postolov & Uri Goldshtein
---

Hi, everyone! I'm [Dimitri Postolov](https://x.com/dimaMachina_) from
[The Guild](https://the-guild.dev), and today I'm excited to announce the new
[graphql.org](/) website.

2 months ago, we released a new GraphQL website after 8 weeks period of development, we're excited
to share with you the reasons behind the changes and what you can expect going forward.

## A Little Dive into History

An initial version of graphql.org v0 was created
[almost 8 years ago](https://github.com/graphql/graphql.github.io/pull/76) by
[Lee Byron](https://x.com/leeb) in 2016.

![Screenshot of initial version of graphql.org v0](./graphql-org-v0.gif)

<p className="text-center">An initial version of graphql.org v0</p>

Later,
[after 4 years in 2020](https://github.com/graphql/graphql.github.io/pull/896),
the website was migrated to Gatsby by The Guild members
[Saihajpreet Singh](https://x.com/singh_saihaj) and
[Arda Tanrikulu](https://x.com/ardatanrikulu).

![Screenshot of graphql.org v1 with Gatsby](./graphql-org-v1.gif)

<p className="text-center">graphql.org v1 x Gatsby</p>

All of us GraphQL developers spent a lot of time learning this language from the
"Learn" page, which is shown below, and you definitely remember it!

> Also, we all disliked visiting this page at night due to the lack of a night
> theme. <span className="not-italic">😅</span>

![Screenshot of graphql.org v1 learn page](./graphql-org-v1-learn-page.png)

<p className="text-center">graphql.org Learn page x Gatsby</p>

With the new website we've made a lot of improvements, including a dark theme!
See how the "Learn" page looks now:

{/* prettier-ignore */}
<div className="mt-6 dark:even:[&_img]:hidden odd:[&_img]:hidden dark:odd:[&_img]:block">
<>![Screenshot of graphql.org v2 learn page](./graphql-org-v2-learn-page-light.png)</>
<>![Screenshot of graphql.org v2 learn page](./graphql-org-v2-learn-page-dark.png)</>
<p className="text-center">graphql.org Learn page x Nextra</p>
</div>

## What's New

Here is a recap of the new features and improvements we've made to the website:

### Migration to Nextra 3 & Vercel

We migrated from Gatsby & Netlify to [Nextra](https://nextra.vercel.app) and
[Next.js](https://nextjs.org). We chose Nextra because it's a great tool for
building documentation websites, also [The Guild](https://the-guild.dev)
maintains and improves it continuously. This migration helped us to improve the
website's performance and developer experience.

This migration was the final part before releasing the upcoming Nextra version.
You can read my blog post about Nextra 3 in
[The Guild blog](https://the-guild.dev/blog/nextra-3). Recently, we migrated all
The Guild documentation websites to Nextra 3, so we know it's stable
for production.

While migrating this website, I started work on the
future Nextra 4 version with [app router support](https://nextjs.org/docs/app).
Once the first Nextra 4 alpha is out, `graphql.org` will be updated to it!

### New Search Engine

Search was migrated from Algolia to Nextra's built-in search
[Flexsearch](https://github.com/nextapps-de/flexsearch), providing users
with realtime results and improved privacy.

### Light and Dark Themes

For the first time since the creation of graphql.org, we have a dark theme! You
can switch between light and dark themes using the toggle in the top right
corner.

### Improved Accessibility

Accessibility and contrast mode have been improved to make the website more
accessible.

### New [/code](/code) and [/community](/community) Pages

We are excited to show [the new Code](/code) page which was renamed to "Tools
and Libraries". You can read in the
[GitHub repo](https://github.com/graphql/graphql.github.io/blob/source/notes/ContributingToCodePage.md)
how to contribute to this page and add your library or tool.

[The community](/community) page was redesigned and restructured; now you
can find all community resources in one place.

### New [/conf](/conf) Page for GraphQLConf 2024

With the new website, we are excited to announce the upcoming GraphQLConf 2024.
More info can be read on [GraphQLConf 2024 page](/conf/2024) or in
[the official announcement blogpost](/blog/2024-03-28-announcing-graphqlconf-2024).

> Also, you can check [the previous conference GraphQLConf 2023](/conf/2023).

## Conclusion

When I started to learn GraphQL in 2018, I could never have imagined that one day I
would be working on this migration! I am excited to be a part of this journey
and to have finally released the new website, a significant improvement over the old one! 🥳

Subscribe to me in [X](https://x.com/dimaMachina_) and
[GitHub](https://github.com/dimaMachina) and see you at GraphQLConf 2024 🚀.
2 changes: 2 additions & 0 deletions src/pages/blog/_meta.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@ import { useConfig } from "nextra-theme-docs"
import NextLink from "next/link"

export default {
// only for blog posts inside folders we need to specify breadcrumb title
"2024-06-11-announcing-new-graphql-website": "Announcing New GraphQL Website",
"*": {
display: "hidden",
theme: {
Expand Down
Loading