docs: Add docs website

[jpadams]

Signed-off-by: Jeremy Adams jeremy@dagger.io

[jpadams]

Uses existing content with Docusaurus magic sprinkled on top (unique IDs, sidebar).

Hyperlinks between docs updated to use Docusaurus unique ID format.

Same workflow to create new docs.

Worked with @crjm to get Mermaid support working :)

Simple structure.

[jpadams]

Thanks for the .md vs .mdx discussion @crjm and @slumbering!

Decided: we'll use .mdx extensions only for those markdown files with jsx inside and .md for static markdown. Both kinds can contain Mermaid diagrams.

[jpadams]

Makes our Cloak docs website the first class way to consume the Cloak docs. Consistent with the current Dagger docs. Incremental revolution of the docs! 😄

[sipsma]

@jpadams First off, thanks for this and all the updates to incorporate the merges to main since you first sent it out!

Second, I tried yarn start locally and saw this in the output:

[WARNING] Docs markdown link couldn't be resolved: (writing_extensions.md) in "/home/sipsma/repo/github.com/sipsma/cloak/docs/unxpq-introduction.mdx" for version current

And then on the localhost site I found that the link Writing an extension in Javascript/Typescript doesn't work on the page bnzm7/writing_extensions. But the Go one right above it does work.

I don't personally think that's a blocker on merging this, but if it's trivial to fix may as well before merge, let me know. Otherwise LGTM

[jpadams]

@jpadams First off, thanks for this and all the updates to incorporate the merges to main since you first sent it out!

Second, I tried yarn start locally and saw this in the output:

[WARNING] Docs markdown link couldn't be resolved: (writing_extensions.md) in "/home/sipsma/repo/github.com/sipsma/cloak/docs/unxpq-introduction.mdx" for version current

And then on the localhost site I found that the link Writing an extension in Javascript/Typescript doesn't work on the page bnzm7/writing_extensions. But the Go one right above it does work.

I don't personally think that's a blocker on merging this, but if it's trivial to fix may as well before merge, let me know. Otherwise LGTM

Thanks for the review, @sipsma ! Taking a look now.

[jpadams]

I did find the broken link though!! Name changes are tough. Love to get ahead of them. Good catch!

[jpadams]

Switched to yarn start -l debug and that caught something!

[sipsma]

Thanks for the fix!

[shykes]

Stupid question: where are the docs hosted?