docs: Document version states

[fsbraun]

Description

This PR adds documentation for the version states, including a diagram explaining the possible transitions.

Related resources

• #...
• #...

Checklist

• I have opened this pull request against master
• I have added or modified the tests when changing logic
• I have followed the conventional commits guidelines to add meaningful information into the changelog
• I have read the contribution guidelines and I have joined #workgroup-pr-review on
  Slack to find a “pr review buddy” who is going to review my pull request.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (fd49df6) 90.95% compared to head (0473993) 90.95%.

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #362   +/-   ##
=======================================
  Coverage   90.95%   90.95%           
=======================================
  Files          72       72           
  Lines        2533     2533           
  Branches      356      356           
=======================================
  Hits         2304     2304           
  Misses        168      168           
  Partials       61       61           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[marksweb]

Great idea to get this in after recent questions raised 👍

[benzkji]

I understand it! Le'ts make the frontend as easy as these docs promise :-)