Set up a published docs site

[markerikson]

I'd like to set up an actual published docs site using Docusaurus.

First step would be to copy over the Docusaurus config that we're using with React-Redux: https://github.com/reduxjs/react-redux/tree/master/website .

I've set up a Netlify project to host this, and am working on getting redux-starter-kit.js.org as a domain name (see js-org/js.org#2571 ).

From there, we can extract the docs content from our current README and move those into separate pages.

Please leave a comment if you'd like to work on this!

[sag1v]

I'm up for it.
Where do you want to move it to until the domain is ready?

[markerikson]

I've got a Netlify site up at https://redux-starter-kit-docs.netlify.com that will host it. Once the domain name is ready, I'll just point it at that site.

In theory, this should mostly just need:

• Copy the existing website folder from React-Redux
• Rename all references from "react-redux" to "redux-starter-kit"
• Create a docs folder with some initial content
• Modify website/sidebars.json to point to the initial file

[sag1v]

Just to be clear...

Copy the existing website folder from React-Redux
Create a docs folder with some initial content

You want to copy the website folder content to redux-starter-kit/website
and create the docs folder in redux-starter-kit/website right?

Modify website/sidebars.json to point to the initial file

The initial file would be the existing redux-starter-kit/website/build/redux-starter-kit/index.html ?

[markerikson]

You want to copy the website folder content to redux-starter-kit/website and create the docs folder in redux-starter-kit/website right?

Yeah, copy-pasting the site config from React-Redux would be the easiest way to get started setting it up for this repo.

Since we don't have any current Markdown docs content for Docusaurus to build, we'll need to create a /docs/ folder and add an initial docs file there. It can probably just be a copy of most of the README for now.

The current redux-starter-kit/website/build/redux-starter-kit/index.html is a placeholder, just so I could say that the Netlify site has valid content when I filed the domain name request. We'll remove that as soon as we have a Docusaurus build system set up.

[sag1v]

Cool, let me know if i need to change things.
note that i copy the index.html from build to docs.

https://github.com/sag1v/redux-starter-kit

[markerikson]

Per my comment, the branch will need to have the config files changed to replace all React-Redux references with the starter kit's name and repo, and the site contents need to get changed.

[sag1v]

Do you see any other references I've missed?

[markerikson]

Yeah, several - left comments appropriately.

[markerikson]

This is done, so closing the issue.