A simple users guide overviewing the basic Cilk keywords and how to u…

[neboat]

…se them.

This PR adds the first of several planned user guides and other documentation covering the basics of Cilk programming.

[netlify]

✅ Deploy Preview for sage-licorice-6da44d ready!

Name	Link
🔨 Latest commit	a717291
🔍 Latest deploy log	https://app.netlify.com/sites/sage-licorice-6da44d/deploys/6788fb8fda802b0008c1d7e0
😎 Deploy Preview	https://deploy-preview-238--sage-licorice-6da44d.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[behoppe]

Thanks @neboat. It's great to see new documentation. What sort of feedback or help would you like from me? I am happy to assist however you like.

The opening section of this documentation (about cilk_spawn and cilk_scope) has a lot in common with https://www.opencilk.org/doc/tutorials/introduction-to-cilk-programming/#adding-parallelism-with-cilk_scope-and-cilk_spawn, and I wonder if we might position them as one building on the other. Right now it seems odd that they don't mention each other.

I'm a bit surprised this doc is located in the users guide, which reinforces my sense that our original documentation framework ("users guide," "tutorial," "reference," etc) is only confusing us and is not serving us. If/when you would like help with organizing documentation, just let me know.

[behoppe]

Thanks @neboat I like the latest edits, and I'm curious what you think of my earlier feedback. If you want me to be the person who merges this, please let me know.

[neboat]

Hey @behoppe , thanks for your response.

Let me keep working on this and some associated docs for a bit longer. The pointer to the existing reference about cilk_scope and cilk_spawn is very helpful, but there's a slightly different organization of the information that I think can work quite well but I'm still sorting out. I'll try and add a couple of those associated docs to this PR in roughly the next week, so you can get some idea of the organization I have in mind.

Indeed, I'm still confused as to what qualifies as a "user guide" vs. a "tutorial" vs. a "reference." Let's come back to that question after I add a little more content.

[behoppe]

OK @neboat sounds like a good plan :-)