5238 set up basic docs structure

[selbekk]

This pull request adds two docs sections - "Getting Started" and "User Guide".

The "Getting Started" part is just a copy of parts of the main README for now, while the "User Guide" just links to the user guide found on GitHub.

And with this - we can actually start the project locally!

Adresses #5238

[Timer]

This can just be the user guide.

[selbekk]

Sure, I'll just copy paste it in there for now. We should probably split it up at some point though.

[selbekk]

Ah sorry, I mis-read you. Yep, will fix the link

[gaearon]

Can we figure out a way to avoid a super visible docs directory until we're actually comfortable with these being final docs? Our users will try to go there and be confused by drafts.

Something like website-docs-wip would work better in the meantime.

[selbekk]

Unfortunately, that seems to be a hard requirement from docusaurus. We could, however, move the entire website folder into a new location, as all docusaurus is asking for is a folder named «docs» as a sibling to the «website» folder.

How about this:

1. move ~/website to ~/docusaurus/website
2. move ~/docs to ~/docusaurus/docs
3. move both one level up once done (if we want to, I think we can put it wherever - but @amyrlam probably knows that better than I)

Sounds like a plan?

[gaearon]

Okay that sounds good.

[amyrlam]

Shall we cut a docusaurus branch off master now and move this PR and #5251 there? A good chunk of selbekk's work got merged, nice! Up for whatever you all prefer. @selbekk sent you a DM on Twitter

[gaearon]

I merged this into master but I also pushed a docusaurus branch.

I agree it probably makes more sense to start working in it directly than create noise on master. How about this arrangement:

• You can both work against docusaurus
• You can review each other's PRs
• Tell me or @Timer (here or on Twitter DM) when you're happy with PRs and we'll press Merge

[gaearon]

Also thanks again for working on this, I'm super excited we'll get a real website!

[amyrlam]

sounds good, thanks!

[selbekk]

Good by me as well :) go team!