Skip to content

Commit 3fc6bde

Browse files
authored
Update seo.mdx
1 parent 27d792d commit 3fc6bde

File tree

1 file changed

+3
-20
lines changed

1 file changed

+3
-20
lines changed

docs/seo.mdx

Lines changed: 3 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
id: seo
3+
title: SEO for CodeHarborHub
34
description: Best practices to improve the SEO (Search Engine Optimization) of the CodeHarborHub documentation site for contributors and maintainers.
45
sidebar_label: SEO
56
keywords:
@@ -10,14 +11,10 @@ keywords:
1011
- docusaurus
1112
---
1213

13-
# SEO for CodeHarborHub
14-
1514
This guide explains how contributors can help improve the **Search Engine Optimization (SEO)** of the [CodeHarborHub](https://codeharborhub.github.io) site.
1615

1716
Good SEO ensures that learners, developers, and collaborators can easily discover our tutorials, projects, and documentation through search engines.
1817

19-
<AdsComponent />
20-
2118
## Why SEO Matters {#why-seo-matters}
2219

2320
SEO makes CodeHarborHub content more **discoverable** to people searching for:
@@ -28,8 +25,6 @@ SEO makes CodeHarborHub content more **discoverable** to people searching for:
2825

2926
Every contributor can help by adding high-quality metadata, semantic content, and structured information to each page.
3027

31-
---
32-
3328
## Global Metadata {#global-metadata}
3429

3530
Site-wide meta tags (keywords, descriptions, structured data) are set inside
@@ -62,12 +57,10 @@ export default {
6257
},
6358
],
6459
};
65-
````
60+
```
6661

6762
These tags help search engines understand the purpose of our site and improve visibility across Google, Bing, and social platforms.
6863

69-
<AdsComponent />
70-
7164
## Per-Page Metadata {#per-page-metadata}
7265

7366
Every Markdown or MDX page should include **front matter** with relevant SEO fields.
@@ -97,8 +90,6 @@ import Head from '@docusaurus/Head';
9790
</Head>
9891
```
9992

100-
<AdsComponent />
101-
10293
## Structured Content & Accessibility {#structured-content}
10394

10495
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:
114105
* Improves accessibility.
115106
* Helps search engines index image content.
116107

117-
---
118-
119108
## Sitemap & Robots {#sitemap-robots}
120109

121110
Docusaurus automatically generates a `sitemap.xml` via `@docusaurus/plugin-sitemap`:
@@ -136,17 +125,13 @@ Disallow:
136125

137126
This allows all search engines to crawl the site.
138127

139-
<AdsComponent />
140-
141128
## Tips for Contributors {#tips-contributors}
142129

143130
* Always fill in **title**, **description**, and **keywords** in front matter.
144131
* Use **meaningful file names** and [slugs](./guides/docs/docs-create-doc.mdx#document-id) for clean URLs.
145132
* Include **publish dates** and **authors** in blog posts for [rich search results](https://search.google.com/test/rich-results).
146133
* Use internal links (`[link text](./target-page)`) to strengthen content relationships.
147134

148-
---
149-
150135
## Rich Social Previews {#rich-social-previews}
151136

152137
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.
159144

160145
</BrowserWindow>
161146

162-
<AdsComponent />
163-
164147
## Final Checklist {#seo-checklist}
165148

166149
Before submitting a pull request:
@@ -171,4 +154,4 @@ Before submitting a pull request:
171154
* [ ] Links use descriptive text instead of *click here*.
172155
* [ ] Internal links connect related tutorials and docs.
173156

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

Comments
 (0)