You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/seo.mdx
+3-20Lines changed: 3 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,6 @@
1
1
---
2
2
id: seo
3
+
title: SEO for CodeHarborHub
3
4
description: Best practices to improve the SEO (Search Engine Optimization) of the CodeHarborHub documentation site for contributors and maintainers.
4
5
sidebar_label: SEO
5
6
keywords:
@@ -10,14 +11,10 @@ keywords:
10
11
- docusaurus
11
12
---
12
13
13
-
# SEO for CodeHarborHub
14
-
15
14
This guide explains how contributors can help improve the **Search Engine Optimization (SEO)** of the [CodeHarborHub](https://codeharborhub.github.io) site.
16
15
17
16
Good SEO ensures that learners, developers, and collaborators can easily discover our tutorials, projects, and documentation through search engines.
18
17
19
-
<AdsComponent />
20
-
21
18
## Why SEO Matters {#why-seo-matters}
22
19
23
20
SEO makes CodeHarborHub content more **discoverable** to people searching for:
@@ -28,8 +25,6 @@ SEO makes CodeHarborHub content more **discoverable** to people searching for:
28
25
29
26
Every contributor can help by adding high-quality metadata, semantic content, and structured information to each page.
30
27
31
-
---
32
-
33
28
## Global Metadata {#global-metadata}
34
29
35
30
Site-wide meta tags (keywords, descriptions, structured data) are set inside
@@ -62,12 +57,10 @@ export default {
62
57
},
63
58
],
64
59
};
65
-
````
60
+
```
66
61
67
62
These tags help search engines understand the purpose of our site and improve visibility across Google, Bing, and social platforms.
68
63
69
-
<AdsComponent />
70
-
71
64
## Per-Page Metadata {#per-page-metadata}
72
65
73
66
Every Markdown or MDX page should include **front matter** with relevant SEO fields.
@@ -97,8 +90,6 @@ import Head from '@docusaurus/Head';
CodeHarborHub uses semantic HTML tags like `<main>`, `<nav>`, `<article>`, and proper heading hierarchy (`#`, `##`, `###`) to help search engines and screen readers understand content structure.
@@ -114,8 +105,6 @@ Always provide **alt text** for images:
114
105
* Improves accessibility.
115
106
* Helps search engines index image content.
116
107
117
-
---
118
-
119
108
## Sitemap & Robots {#sitemap-robots}
120
109
121
110
Docusaurus automatically generates a `sitemap.xml` via `@docusaurus/plugin-sitemap`:
@@ -136,17 +125,13 @@ Disallow:
136
125
137
126
This allows all search engines to crawl the site.
138
127
139
-
<AdsComponent />
140
-
141
128
## Tips for Contributors {#tips-contributors}
142
129
143
130
* Always fill in **title**, **description**, and **keywords** in front matter.
144
131
* Use **meaningful file names** and [slugs](./guides/docs/docs-create-doc.mdx#document-id) for clean URLs.
145
132
* Include **publish dates** and **authors** in blog posts for [rich search results](https://search.google.com/test/rich-results).
146
133
* Use internal links (`[link text](./target-page)`) to strengthen content relationships.
147
134
148
-
---
149
-
150
135
## Rich Social Previews {#rich-social-previews}
151
136
152
137
Social platforms like Twitter, LinkedIn, and Facebook use Open Graph and Twitter Card metadata.
@@ -159,8 +144,6 @@ Contributors can customize images per page for better share previews.
159
144
160
145
</BrowserWindow>
161
146
162
-
<AdsComponent />
163
-
164
147
## Final Checklist {#seo-checklist}
165
148
166
149
Before submitting a pull request:
@@ -171,4 +154,4 @@ Before submitting a pull request:
171
154
*[ ] Links use descriptive text instead of *click here*.
172
155
*[ ] Internal links connect related tutorials and docs.
173
156
174
-
Good SEO is a team effort—your contributions make **CodeHarborHub** more discoverable and valuable to learners worldwide.
157
+
Good SEO is a team effort—your contributions make **CodeHarborHub** more discoverable and valuable to learners worldwide.
0 commit comments