Update docs for the website

[sockeqwe]

DON'T merge this yet.

I try to update the docs while we merge the changes into main. Once everything new is released, we can merge this PR too.

It updates:

• condition block replaces inStateWithCondition.

[sockeqwe]

@gabrielittner I have a hard time finding a good example for untilIdentityChanged block for the docs. Do you have one?

[gabrielittner]

The simplest one I can come up with is you have a screen with search. Then you can make the search query the identity and have a collectWhileInState that uses the input state which restarts the block whenever the query changes.

[sockeqwe]

@gabrielittner what do you think about this example and explanation about untilIdentityChanged?

[gabrielittner]

Looks good to me 👍

[gabrielittner]

Thanks for updating all of this it's a great improvement. I still need to read the sub state machine and testing parts, but already wanted to leave comments.

[gabrielittner]

extreme nit: I really dislike Throwables in state because they lead to all these technical error messages that a user should never see but some websites and apps show to users

[sockeqwe]

Agreed, it is also hard to test s data class with exceptions. Will change that example later tonight

[sockeqwe]

Updated with an error message instead of throwable. Was considering removing it completely, but then the docs would change from object Error to data class Error somewhen along the way (for the error countdown example) ... Maybe we change it later

[gabrielittner]

Looks good to me 👍

[gabrielittner]

This part is really nice

[sockeqwe]

I have updated the navigation for the page (mkdocs.yml).

I am not 100% sure if it works as expected in "production" but I think we could simply merge this PR and find it out :) 😄

This is how it should look like (at least it looks like this on my machine: