Clarified experimental nature of crux in its own section, which state…

[mhedgpeth]

…s the path to 1.0.

As I read through the docs, I was curious as to what made the software experimental. When I asked on Zulip, I learned that the app is used in production, and that the experimental nature of it is really related to its API and use cases.

So I clarified that in the topic, to hopefully make it easier for people to onboard.

In addition, when looking at this, one early problem I had with crux is the lack of Windows Desktop support, and a few hours of research later, I realized that it would be super early and barely an inconvenience with C#/WinUI3 or WPF/PInvoke - it just needs to be done. So I included that callout to hopefully help people who were thinking about crux for the first time.

[fraschm1998]

I was reading the same thread and you mentioned updating the docs for newcomers, I've been using chatgpt to help wrap my head around how crux works and I found it easier to understand than the current docs. Here's a partial chat history, perhaps this part of this could be used: https://chatgpt.com/share/674b2e9d-323c-800f-996a-3b80d1fe8a91

[charypar]

Thanks for making a start on this! Sorry it took me so long to get to it. I've suggested some minor wording changes, please let me know if you're happy with them.

[charypar]

@fraschm1998 thanks for that! I enjoed reading it, the robot analogy is great 😄 Definitely some analogies and explanations worth stealing in that conversation.

[charypar]

Some of ChatGPT's ... chat :) about when to send an event in a coroutine and when to call it synchronously are not quite right I don't think, but they point to a missing piece of documentation to write - how the shells should deal with concurrency and how the core fits in.

[mhedgpeth]

@charypar thanks for the feedback! I accepted your suggestions. I believe that puts my PR in an acceptable state.

[charypar]

@mhedgpeth There's about three more suggestions to get in unless you don't agree with those. Let me know.

Other than that I'm happy to merge this.

[mhedgpeth]

Fantastic, everything is accepted. Thanks for working with me on this

[charypar]

Thanks for pushing us to do this @mhedgpeth!