-
Notifications
You must be signed in to change notification settings - Fork 1.5k
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
Changes from 14 commits
Commits
Show all changes
19 commits
Select commit
Hold shift + click to select a range
7158075
graphql website blog
dimaMachina f26a0c1
Merge branch 'source' into new-website-blog
dimaMachina 2f64956
polish by Benjie suggestions
dimaMachina 948f472
one more fix
dimaMachina a90a6ca
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina 69e801a
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina d3bdc7a
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina c76c6f1
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina 0aa22fa
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina f0de752
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina b7d2721
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina 869d18b
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina 6b94d14
Update src/pages/blog/2024-06-08-announcing-new-graphql-website/index…
dimaMachina db72766
apply little comma fix
dimaMachina 13a13fb
optimized images
dimaMachina 49c07ab
update date
dimaMachina dafc351
remove `bundle size` improve phrase since Idk how to properly calcula…
dimaMachina 7637a63
add `and developer experience`
dimaMachina ef8cd98
remove section of `Better Bundle Size and First Load Time`
dimaMachina File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Binary file added
BIN
+4.66 MB
src/pages/blog/2024-06-08-announcing-new-graphql-website/graphql-org-v0.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+240 KB
...es/blog/2024-06-08-announcing-new-graphql-website/graphql-org-v1-learn-page.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+5.52 MB
src/pages/blog/2024-06-08-announcing-new-graphql-website/graphql-org-v1.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+405 KB
...og/2024-06-08-announcing-new-graphql-website/graphql-org-v2-learn-page-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+410 KB
...g/2024-06-08-announcing-new-graphql-website/graphql-org-v2-learn-page-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
124 changes: 124 additions & 0 deletions
124
src/pages/blog/2024-06-08-announcing-new-graphql-website/index.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,124 @@ | ||
--- | ||
title: Announcing New GraphQL Website | ||
tags: [announcements] | ||
date: 2024-06-08 | ||
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. | ||
|
||
 | ||
|
||
<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). | ||
|
||
 | ||
|
||
<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> | ||
|
||
 | ||
|
||
<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"> | ||
<></> | ||
<></> | ||
<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 bundle size. | ||
|
||
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. | ||
|
||
### Better Bundle Size and First Load Time | ||
|
||
The new website has a better bundle size and first load time compared to the | ||
previous version. | ||
|
||
### 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 🚀. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If you have any numbers on this (reduced by X% and now loads Y times faster), that would be a great addition. No worries if not!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I tried and I don't know how to properly measure this transition between Gatsby and Next.js, so I just completely removed this paragraph