More initial docs

[andreaTP]

Here:

• a little more structure
• started porting a couple of section of the Readme (with jbang checks etc.)
• ported the initial Blog we wrote for Java Advent

Next:

• more structure
• a more scalable way to test the docs
• port the rest of the Readme

[bhelx]

Going to see why cloudflare didn't build this preview branch. I suspect because because this is a fork.

[andreaTP]

Probably the preview doesn't work on PRs from forks.
I think you can trust me this time as it's really an in progress work, I'll push to the main repo next time.

[andreaTP]

I don't see the site being updated after the merge, @bhelx I think I need your intervention here 🙏

[bhelx]

Seems that the build failed because some updates to yarn.lock weren't checked in. will see if i can fix:

15:55:49.937 | ➤ YN0000: └ Completed in 0s 241ms
-- | --
15:55:50.000 | ➤ YN0000: ┌ Post-resolution validation
15:55:50.000 | ➤ YN0028: │ The lockfile would have been modified by this install, which is explicitly forbidden.
15:55:50.000 | ➤ YN0000: └ Completed
15:55:50.000 | ➤ YN0000: Failed with errors in 0s 313ms
15:55:50.021 | Error: Exit with error code: 1
15:55:50.021 | at ChildProcess.<anonymous> (/snapshot/dist/run-build.js)
15:55:50.022 | at Object.onceWrapper (node:events:652:26)
15:55:50.022 | at ChildProcess.emit (node:events:537:28)
15:55:50.022 | at ChildProcess._handle.onexit (node:internal/child_process:291:12)
15:55:50.030 | Failed: build command exited with code: 1
15:55:51.490 | Failed: error occurred while running build command

[bhelx]

I had to delete yarn.lock. should be deployed and working again.

[andreaTP]

Looks good! Thanks for looking into this quickly and sorry for the noise.
We should put yarn.lock in the .gitignore file, I'll follow up tomorrow.