How to tell if a Google App Engine documentation page applies to the 1st/2nd generation standard or the flexible environment

7
votes

I see a lot of questions from users mixing up the standard environment with the flexible environment, especially when it comes to documentation, often attempting to follow the wrong instructions, obviously with undesired results.

How can one easily tell which GAE environment a certain page is applicable to?

1
google-app-engineapp-engine-flexible

1 Answers

11
votes

Most (if not all) of the GAE documentation is structured by the environment. When looking at a certain documentation page the environment is clearly indicated in several places:

  • the second section at the top of the left-side documentation navigation bar
  • the navigation trail at the top of the actual documentation page (which may vary slightly depending on the programming language)
  • the docs/flexible vs docs/standard strings in the doc page URLs
  • some pages applicable to multiple programming languages and/or environments (maybe with small differences) have tabs indicating:
    • the currently selected language and environment
    • the other languages and environments the page applies to (selectable)
    • the languages and environments the page doesn't apply to (grayed out)

Examples:

enter image description here enter image description here enter image description here enter image description here

If the documentation page doesn't show the above mentioned patterns (for example if it's a page about some other Google Cloud product somehow related to the App Engine), then check about the App Engine feature being discussed and try to locate the respective GAE documentation.

What may also help with the distinction would be to check these guides putting the 2 environments and/or their features side by side:

Note: when multiple language versions are listed/mentioned under the standard environment (excepting Node.js) they refer to the 1st and 2nd generation standard environment, significantly different from each-other. You should also check the comparison and/or migration guides for these cases: