facebook / facebook/docusaurus

Audit i18n SEO issues: hreflang, x-default, canonical...

Open
#6,075 10 comments 0 reactions 0 assignees View on GitHub
domain: i18n proposal
Dominant language
TypeScript
Stars
66.2k
Forks
10k
Avg merge
1d 3h
Merged PRs (30d)
52

Description

### Have you read the Contributing Guidelines on issues?

- [X] I have read the [Contributing Guidelines on issues](https://github.com/facebook/docusaurus/blob/main/CONTRIBUTING.md#reporting-new-issues).

### Motivation

It has been reported that we may not implement correctly meta page headers for SEO

https://github.com/facebook/docusaurus/issues/3317#issuecomment-975150571
https://github.com/facebook/docusaurus/issues/3317#issuecomment-989136495

Let's discuss here what we do wrong exactly, and what we should do instead.

Please link to reference material from an SEO authoritative source (Google, Moz...) whenever possible.
It's not always so easy to interpret these docs correctly.

Please give concrete examples of what we do wrong and how to solve the problem.
- Page link: ...
- Current wrong meta headers: ...
- Expected (good) meta headers: ...
- Ref link: ...

cc @mxhdx @thadguidry

### Self-service

- [ ] I'd be willing to do some initial work on this proposal myself.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.