Convert our GitHub docs to MDX in Next.js

[cindyorangis]

docusaurus is a neat way to organize and maintain markdown docs. It's used in many Facebook repositories and I think we could totally implement it in our project as well.

Here is an example from create-react-app:

All of their markdown documents show up like

https://create-react-app.dev/docs/getting-started

[cindyorangis]

@seanprashad you're not on the assignees list for some reason so I'm tagging you here

[humphd]

Sent @seanprashad an invite to be a collaborator on the repo.

[cindyorangis]

Mentioned by @humphd a while ago that this can be achieved using Gatsby as well.
https://www.gatsbyjs.org/docs/adding-markdown-pages/

I will likely morph this into Gatsby markdown pages in the future instead of implementing docusaurus.

[c3ho]

Let's leave this for post 1.0

[cindyorangis]

Find something similar to this https://material-ui.com/components/tabs/ for Gatsby...
Idea: have this kind of set up for installation instructions for each OS

[Linux][Mac][Windows]

[instructions... ]

[humphd]

Morph this into a bug about doing the same thing in next.js. cc @chrispinkney, related to #1463 for followup.

[cindyorangis]

Once #1463 gets resolved, I'd like to progress forward with this. After so many morphs, I think MDX with Next.js will be the one to actually get implemented.

https://nextjs.org/blog/markdown looks promising.

[izhuravlev]

cc @birtony @izhuravlev

[chrispinkney]

So because MDX is now landed this issue could be a lot of fun for whoever wants to work on it.

NextJS can automatically generate routes for files found in the pages directory (see /search and /about). Because of this (and because of a Pagebase being landed) we can simply pull in the docs in the /docs folder, apply the pagebase, and rinse and repeat (see this pr for info on how this could happen.)

Also, this issue also depends on UI 2.0 as our docs that get rendered will need a touch up or sorts, thus I think this should go in after UI 2.0.

[chrispinkney]

@manekenpix Are you still curious about working on this? Anton has expressed interest in this today, maybe you guys would like to collab?

[manekenpix]

Yes, definitely 👍