There should be right up front, a crystal clear page detailing the three possible environments.
- Legacy Standard (WITH A VERY CLEAR DEPRECATION NOTICE)
- Legacy Flexible (WITH A VERY CLEAR DEPRECATION NOTICE)
- Standard Second Generation GVisor
For example, in Python Standard (old standard), it's extremely confusing to work out which gcloud libraries are bundled, and which need to be vendored and packaged into the app (yes I know there is a page that tries to explain. It's unclear).
Thank you for working on the documentation. It is the number one area that GCP needs to invest in. All the technology is miles ahead of AWS in the core areas. The docs however, are very very far behind.
Happy to elaborate more if there's any specifics you need.