Migrate Handbook Pages into MDX Collections #7223

Rajesh-Nagarajan-11 · 2025-12-05T14:46:38Z

Currently

The Community Handbook pages are currently managed statically, with each page and navigation item

Description

This PR fixes [Handbook] Table of Contents need to be dynamically generated #6926
This PR migrates the community handbook pages into an MDX collection and enables dynamic navigation rendering for improved maintainability.

Notes for Reviewers

Migrate all pages into the MDX collection under src/collections/handbook
Move all images into their respective collection folders (if any)
Ensure all content is properly migrated to MDX
Ensure all styles are preserved after migration
Remove unwanted files (old pages) and unused assets
Configure GraphQL queries for MDX collections
Ensure all collections are dynamically generated
In this PR, two files : src/sections/Community/Handbook/BookComponent/BookComponent.js and src/sections/Community/Meshmates/index.js — are shown as modified, but there are actually no changes in them. Please ignore those files.

Signed commits

Yes, I signed my commits.

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

l5io · 2025-12-05T15:03:46Z

🚀 Preview for commit 0d7f1de at: https://6932f417e8593695c41da815--layer5.netlify.app

leecalcote · 2025-12-05T16:04:57Z

@Rajesh-Nagarajan-11, this is great to see. Does this mean no more hardcoded navigation menu for the handbook?

Rajesh-Nagarajan-11 · 2025-12-05T16:06:10Z

Yes @leecalcote no more hard-coded menu

src/collections/handbook/writing-program/index.mdx

src/collections/handbook/github-process/index.mdx

src/sections/Community/Handbook/handbook-single/HandbookTOC.js

src/collections/handbook/community/index.mdx

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

src/collections/handbook/community/index.mdx

src/collections/handbook/community-roles/index.mdx

src/collections/handbook/mentorship-programs/programs-data.js

src/collections/handbook/community/index.mdx

src/collections/handbook/faq/index.mdx

l5io · 2025-12-06T13:37:11Z

🚀 Preview for commit 0c7ad82 at: https://6934313c680ce18435afb3c0--layer5.netlify.app

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

l5io · 2025-12-06T14:39:43Z

🚀 Preview for commit ab65391 at: https://69343fdc7e978ab9651c8a74--layer5.netlify.app

kishore08-07

Good work @Rajesh-Nagarajan-11
LGTM

CodexRaunak · 2025-12-06T15:18:57Z

Great work @Rajesh-Nagarajan-11.🚀

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

l5io · 2025-12-06T15:43:42Z

🚀 Preview for commit b820cf0 at: https://69344ef5bc13a9dc0dbfa1e5--layer5.netlify.app

l5io · 2025-12-06T18:11:19Z

🚀 Preview for commit f75ad16 at: https://693471861e48342986c632ee--layer5.netlify.app

saurabhraghuvanshii · 2025-12-06T19:06:42Z

src/collections/handbook/about/index.mdx

+contents:
+  - id: 0
+    link: "#About Layer5"
+    text: "About Layer5"
+  - id: 1
+    link: "#Goals"
+    text: "Goals"
+  - id: 2
+    link: "#Newcomer's Path"
+    text: "Newcomer's Path"
+  - id: 3
+    link: "#Working on your issue"
+    text: "Working on your issue"
+  - id: 4
+    link: "#While your issue is under review"
+    text: "While your issue is under review"
+---


links are not working

The link is not working on all pages that are using it. I think there might be an issue with the template definition — please look into it.

saurabhraghuvanshii · 2025-12-06T19:18:51Z

src/collections/handbook/connect-with-us/index.mdx

+Layer5 is dedicated to empowering engineers and supporting the open source community that create them. Learn more about Layer5 and connect with the community by following and engaging with us on our social media accounts.
+
+<div>
+  <p className="channels-para"><img className="channels-img" src={twitter_icon} alt="twitter" />&nbsp;&nbsp;<a href="https://x.com/layer5">@layer5</a>,&nbsp;<a href="https://x.com/mesheryio">@mesheryio</a>&nbsp;and&nbsp;<a href="https://x.com/kanvas-new">@kanvas-new</a></p>


Suggested change

<p className="channels-para"><img className="channels-img" src={twitter_icon} alt="twitter" />  <a href="https://x.com/layer5">@layer5</a>, <a href="https://x.com/mesheryio">@mesheryio</a> and <a href="https://x.com/kanvas-new">@kanvas-new</a></p>

<p className="channels-para"><img className="channels-img" src={twitter_icon} alt="twitter" />  <a href="https://x.com/layer5">@layer5</a>, <a href="https://x.com/mesheryio">@mesheryio</a> and <a href="https://x.com/kanvas-new">@kanvas-new</a></p>

https://x.com/kanvas-new
page doesn’t exist.

saurabhraghuvanshii · 2025-12-06T19:28:26Z

src/collections/handbook/github -organization/index.mdx

@@ -0,0 +1,70 @@
+---


file naming is incorrect

src/sections/Community/Handbook/BookComponent/BookComponent.js

src/sections/Community/Meshmates/index.js

saurabhraghuvanshii · 2025-12-06T20:09:13Z

src/collections/handbook/github -organization/index.mdx

@@ -0,0 +1,70 @@
+---
+title: "GitHub Organization"


Suggested change

title: "GitHub Organization"

title: "GitHub Organization Membership"

saurabhraghuvanshii · 2025-12-06T20:16:21Z

src/collections/handbook/designer/index.mdx

+
+ the user experience of any of our projects, please share them with us.


Suggested change

the user experience of any of our projects, please share them with us.

the user experience of any of our projects, please share them with us.

keep in one line, because of that there is line breaking on page

saurabhraghuvanshii · 2025-12-06T20:29:49Z

@Rajesh-Nagarajan-11 I noticed another issue with the current change. Clicking on items in the Table of Contents causes the page to reload, but it should navigate smoothly without reloading.

Rajesh-Nagarajan-11 and others added 30 commits December 3, 2025 22:40

initial migration

680f922

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

handbook template

0d112d0

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

gatsby node update

08312a2

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

remove static pages

72c1148

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

Merge branch 'master' into handbook-migration

0f42428

fix import paths

f25f9b7

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

fix path 2

17b7d6b

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

eslint fix of index.js

1212043

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

fix build errors 1

08d96bd

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

table of content fix and next-prev button fix

6ddf4c2

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

table of content fix and next-prev button fix 2

fe92349

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

fix path 3

956f9d5

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

Merge branch 'layer5io:master' into handbook-migration

417b000

rename to github org

35bb350

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

fix intra page

51d96c6

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

fix intra page 2

5ddc31e

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

revert last 2 commits

2ca7743

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

removed unused images

25f7a4a

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

handbook margin fix

3f2b62e

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

handbook home page dynamic imports

68b410b

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

update desc of all pages

bbb0d66

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

removed duplicate mdx

54fe184

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

Merge branch 'master' into handbook-migration

ad61c31

revert the deleted bookcomponent

1d67516

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

moved bookcomponent to crt folder

371b97b

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

Merge branch 'master' into handbook-migration

57fde17

Merge branch 'layer5io:master' into handbook-migration

97380ad

intra-page link fix

18f3c14

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

adjust top spacing

44b9439

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

Merge branch 'layer5io:master' into handbook-migration

682dc08

github-actions bot added area/community area/handbook area/site-config labels Dec 5, 2025

leecalcote requested a review from Fireentity December 5, 2025 16:04

kishore08-07 suggested changes Dec 6, 2025

View reviewed changes

Rajesh-Nagarajan-11 and others added 2 commits December 6, 2025 18:50

Merge branch 'master' into handbook-migration

9233241

added missing content and fix toc active

0c7ad82

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

CodexRaunak suggested changes Dec 6, 2025

View reviewed changes

Rajesh-Nagarajan-11 added 2 commits December 6, 2025 19:15

fix grammers

f31a84f

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

gsod archived

ab65391

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

kishore08-07 approved these changes Dec 6, 2025

View reviewed changes

Updated Handbook TOC for improved mobile compatibility

b820cf0

Signed-off-by: Rajesh-Nagarajan-11 <[email protected]>

Rajesh-Nagarajan-11 requested a review from CodexRaunak December 6, 2025 15:38

Merge branch 'master' into handbook-migration

f75ad16

CodexRaunak approved these changes Dec 6, 2025

View reviewed changes

Rajesh-Nagarajan-11 requested review from leecalcote and saurabhraghuvanshii December 6, 2025 18:21

ChetanFTW approved these changes Dec 6, 2025

View reviewed changes

saurabhraghuvanshii requested changes Dec 6, 2025

View reviewed changes

saurabhraghuvanshii reviewed Dec 6, 2025

View reviewed changes

	<p className="channels-para"><img className="channels-img" src={twitter_icon} alt="twitter" />  <a href="https://x.com/layer5">@layer5</a>, <a href="https://x.com/mesheryio">@mesheryio</a> and <a href="https://x.com/kanvas-new">@kanvas-new</a></p>
	<p className="channels-para"><img className="channels-img" src={twitter_icon} alt="twitter" />  <a href="https://x.com/layer5">@layer5</a>, <a href="https://x.com/mesheryio">@mesheryio</a> and <a href="https://x.com/kanvas-new">@kanvas-new</a></p>

	title: "GitHub Organization"
	title: "GitHub Organization Membership"


		the user experience of any of our projects, please share them with us.

Migrate Handbook Pages into MDX Collections #7223

Are you sure you want to change the base?

Migrate Handbook Pages into MDX Collections #7223

Conversation

Rajesh-Nagarajan-11 commented Dec 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

l5io commented Dec 5, 2025

Uh oh!

leecalcote commented Dec 5, 2025

Uh oh!

Rajesh-Nagarajan-11 commented Dec 5, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

l5io commented Dec 6, 2025

Uh oh!

l5io commented Dec 6, 2025

Uh oh!

kishore08-07 left a comment

Choose a reason for hiding this comment

Uh oh!

CodexRaunak commented Dec 6, 2025

Uh oh!

l5io commented Dec 6, 2025

Uh oh!

l5io commented Dec 6, 2025

Uh oh!

saurabhraghuvanshii Dec 6, 2025

Choose a reason for hiding this comment

Uh oh!

saurabhraghuvanshii Dec 6, 2025

Choose a reason for hiding this comment

Uh oh!

saurabhraghuvanshii Dec 6, 2025

Choose a reason for hiding this comment

Uh oh!

saurabhraghuvanshii Dec 6, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

saurabhraghuvanshii Dec 6, 2025

Choose a reason for hiding this comment

Uh oh!

saurabhraghuvanshii Dec 6, 2025

Choose a reason for hiding this comment

Uh oh!

saurabhraghuvanshii commented Dec 6, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

Rajesh-Nagarajan-11 commented Dec 5, 2025 •

edited

Loading