Docusaurus: Improve SEO

[azz]

Is this a bug report?

enhancement.

Have you read the Contributing Guidelines?

👍

Issue

Google search results for Prettier could do with some improvement.

Short listing

Long listing (Requires searching for "prettier.io")

I'm not an expert on SEO, but I think there should be an option to set:

• <meta name="description" content="...">
• Sitemap (maybe using https://github.com/algolia/algolia-sitemap?)

Reproducible Demo

Search: https://google.com/search?q=prettier.io
Repo: https://github.com/prettier/prettier
Site: https://prettier.io

[j-f1]

let num = Math.floor (Math.random() * 1E+7).toString().replace ...

That’s definitely not what we’re looking for to describe the playground.

[JoelMarcey]

Ok, I am convinced that we need to do a bit better given the random code snippet for the playground 😄

[amyrlam]

I'll work on this with @jason-maier. He's new to Docusaurus, but has some SEO experience from his past career!

[endiliey]

I think this has been fixed 😄

You can set your own description meta
<meta name="description" content="...">

Refer to https://docusaurus.io/docs/en/api-pages#description-for-pages

Example:

// pages/index.js

const React = require('react');

class Index extends React.Component {
  render() {
    // ... your rendering code
  }
}

Index.description = 'Endilie is an undergraduate student at Nanyang Technological University (2019). He likes to write & code in his free time';
module.exports = Index;

Google's result:

I'm closing this. Feel free to re-open / create a new issue if needed