Skip to content

Commit 1e24b6a

Browse files
committed
aa
1 parent bea3ba9 commit 1e24b6a

File tree

3 files changed

+59
-28
lines changed

3 files changed

+59
-28
lines changed

.prettierignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
11
public/
22
pnpm-lock.yaml
33
*.mdx
4+
!src/pages/blog/2024-04-11-announcing-new-graphql-website/index.mdx

prettier.config.js

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,14 @@ export default {
99
files: "*.svg",
1010
options: { parser: "html" },
1111
},
12+
{
13+
files: "*.mdx",
14+
options: {
15+
proseWrap: "always", // printWidth line breaks in md/mdx
16+
semi: false,
17+
trailingComma: "none",
18+
},
19+
},
1220
],
1321
plugins: [
1422
// For sort fields in package.json

src/pages/blog/2024-04-11-announcing-new-graphql-website/index.mdx

Lines changed: 50 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -6,37 +6,46 @@ byline: Dimitri POSTOLOV & Uri GOLDSHTEIN
66
---
77

88
Hi, everyone! I'm [Dimitri POSTOLOV](https://x.com/dimaMachina_) from
9-
[The Guild](https://the-guild.dev), and today I'm excited to announce the new [GraphQL.org](/)
10-
website.
9+
[The Guild](https://the-guild.dev), and today I'm excited to announce the new
10+
[GraphQL.org](/) website.
1111

12-
2 weeks ago, we released a new GraphQL website. We've been working on this for about 2 months, and
13-
we're excited to share it with you.
12+
2 weeks ago, we released a new GraphQL website. We've been working on this for
13+
about 2 months, and we're excited to share it with you.
1414

1515
## A Little Dive into History
1616

17-
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.
17+
An initial version of GraphQL.ORG v0 was created
18+
[almost 8 years ago](https://github.com/graphql/graphql.github.io/pull/76) by
19+
[Lee BYRON](https://x.com/leeb) in 2016.
1820

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

2123
<p className="text-center">An initial version of GraphQL.ORG v0</p>
2224

23-
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
25+
Later,
26+
[after 4 years in 2020](https://github.com/graphql/graphql.github.io/pull/896),
27+
the website was migrated to Gatsby by The Guild members
28+
[Saihajpreet SINGH](https://x.com/singh_saihaj) and
2429
[Arda TANRIKULU](https://x.com/ardatanrikulu).
2530

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

2833
<p className="text-center">GraphQL.ORG v1 x Gatsby</p>
2934

30-
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!
35+
All of us GraphQL developers spent a lot of time learning this language from the
36+
"Learn" page, which is shown below, and you definitely remember it!
3137

32-
> Also, we all hated visiting this page at night due to the lack of a night theme. <span className="not-italic">😅</span>
38+
> Also, we all hated visiting this page at night due to the lack of a night
39+
> theme. <span className="not-italic">😅</span>
3340
3441
![Screenshot of GraphQL.ORG v1 learn page](./graphql-org-v1-learn-page.png)
3542

3643
<p className="text-center">GraphQL.ORG Learn page x Gatsby</p>
3744

38-
With the new website, we've made a lot of improvements, including a dark theme, below how the "Learn" page looks like:
45+
With the new website, we've made a lot of improvements, including a dark theme,
46+
below how the "Learn" page looks like:
3947

48+
{/* prettier-ignore */}
4049
<div className="mt-6 dark:even:[&_img]:hidden odd:[&_img]:hidden dark:odd:[&_img]:block">
4150
<>![Screenshot of GraphQL.ORG v2 learn page](./graphql-org-v2-learn-page-light.png)</>
4251
<>![Screenshot of GraphQL.ORG v2 learn page](./graphql-org-v2-learn-page-dark.png)</>
@@ -49,53 +58,66 @@ Here is a recap of the new features and improvements we've made to the website:
4958

5059
### Migration to Nextra 3 & Vercel
5160

52-
We migrated from Gatsby & Netlify to [Nextra](https://nextra.vercel.app) and [Next.js](https://nextjs.org).
53-
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.
54-
This migration helped us to improve the website's performance and bundle size.
61+
We migrated from Gatsby & Netlify to [Nextra](https://nextra.vercel.app) and
62+
[Next.js](https://nextjs.org). We chose Nextra because it's a great tool for
63+
building documentation websites, also [The Guild](https://the-guild.dev)
64+
maintains and improves it continuously. This migration helped us to improve the
65+
website's performance and bundle size.
5566

56-
This migration was the final part before releasing the upcoming Nextra version. You can read my blog post
57-
about Nextra 3 in [The Guild blog](https://the-guild.dev/blog/nextra-3). Recently, we migrated all
58-
The Guild documentation websites to Nextra 3, and we can assume that it's stable for production.
67+
This migration was the final part before releasing the upcoming Nextra version.
68+
You can read my blog post about Nextra 3 in
69+
[The Guild blog](https://the-guild.dev/blog/nextra-3). Recently, we migrated all
70+
The Guild documentation websites to Nextra 3, and we can assume that it's stable
71+
for production.
5972

60-
Also, at the same time while migrating this website, I started to work on the future Nextra 4 version
61-
with [app router support](https://nextjs.org/docs/app).
73+
Also, at the same time while migrating this website, I started to work on the
74+
future Nextra 4 version with [app router support](https://nextjs.org/docs/app).
6275
Once the first Nextra 4 alpha is out, this website be updated too!
6376

6477
### New Search Engine
6578

66-
A search was migrated from Algolia to Nextra's built-in search [Flexsearch](https://github.com/nextapps-de/flexsearch)
79+
A search was migrated from Algolia to Nextra's built-in search
80+
[Flexsearch](https://github.com/nextapps-de/flexsearch)
6781

6882
### Light and Dark Themes
6983

70-
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.
84+
For the first time, since the creation of GraphQL.ORG, we have a dark theme! You
85+
can switch between light and dark themes using the toggle in the top right
86+
corner.
7187

7288
### Improved Accessibility
7389

74-
Accessibility and contrast mode have been improved to make the website more accessible.
90+
Accessibility and contrast mode have been improved to make the website more
91+
accessible.
7592

7693
### Better Bundle Size and First Load Time
7794

78-
The new website has a better bundle size and first load time compared to the previous version.
95+
The new website has a better bundle size and first load time compared to the
96+
previous version.
7997

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

82-
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)
100+
We are excited to show [the new Code](/code) page which was renamed to "Tools
101+
and Libraries". You can read in the
102+
[GitHub repo](https://github.com/graphql/graphql.github.io/blob/source/notes/ContributingToCodePage.md)
83103
how to contribute to this page and add your library or tool.
84104

85-
[The community](/community) page was redesigned and restructured. And now you can find all community resources in one place.
105+
[The community](/community) page was redesigned and restructured. And now you
106+
can find all community resources in one place.
86107

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

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

92114
> Also, you can check [the previous conference GraphQLConf 2023](/conf/2023).
93115
94116
## Conclusion
95117

96-
When I started to learn GraphQL in 2018 I could never imagine that one day I would be working on this
97-
migration! I am excited to be a part of this journey and finally release the new website which is much
98-
better than the previous 🥳.
118+
When I started to learn GraphQL in 2018 I could never imagine that one day I
119+
would be working on this migration! I am excited to be a part of this journey
120+
and finally release the new website which is much better than the previous 🥳.
99121

100122
Subscribe to me in [X](https://x.com/dimaMachina_) and
101123
[GitHub](https://github.com/dimaMachina) and see you in GraphQLConf 2024 🚀.

0 commit comments

Comments
 (0)