Document when latest release of arcgis package is not compatible with Pro's default python environment

[PeterKnoop]

When a new major/minor version of the arcgis package is first released, it often is not compatible with the default python environment available in the latest release of ArcGIS Pro. 

Since much of the documentation talks about first cloning the default Pro python environment, and then upgrading/installing arcgis into the cloned environment, the documentation should discuss this. Many users are not knowledgeable enough about arcgis and conda/python to understand that at times there are incompatibilities between the latest release of arcgis' requirements and the default python environment they have in Pro.

For example, the current arcgis release, 2.4.0, is not compatible with the default python environment in the currently released version of Pro, 3.3. Once Pro 3.4 is released, then it will compatible, however, in the meantime, many users are being set up for failure.

[achapapkowski]

Peter, 

Have you see this documentation about the deprecations and change information? 

https://developers.arcgis.com/python/latest/guide/release-notes-240/

https://developers.arcgis.com/python/latest/guide/deprecation-notices/ 

Additionally our API documentation is version for the latest release and the previous release. 

latest: https://developers.arcgis.com/python/latest/

previous: https://developers.arcgis.com/python-2-3/

For even earlier documentation, please see: https://esri.github.io/arcgis-python-api

For samples and guides, they are now versioned, and can be found on this page: https://developers.arcgis.com/python/latest/ 

Let me know if you feel we are missing something after you review the docs.  You can also post your thoughts on the public github page: https://github.com/Esri/arcgis-python-api/issues

Thank you,

Andrew

[DavidSolari]

At first thought, the easiest solution is to pin the required Python versions to the supported versions of Pro when the Conda package for the esri channel is built. The Pypi and non-esri channel Conda packages can continue to list a wider range of Python versions as that's not what Pro's package manager will look for.

[PeterKnoop]

@achapapkowski The warning recently added right at the top of the page for Install and set up --> ArcGIS Pro is perfect! I think that will be very helpful in preventing users from wasting time going down a path that will fail.

[HannesZiegler]

Closing this idea as per conversation above:

To find information about ArcGIS API & ArcGIS Pro Python environment compatibility, please see the following:

https://developers.arcgis.com/python/latest/guide/release-notes-240/

https://developers.arcgis.com/python/latest/guide/deprecation-notices/ 

Additionally our API documentation is version for the latest release and the previous release. 

latest: https://developers.arcgis.com/python/latest/

previous: https://developers.arcgis.com/python-2-3/

For even earlier documentation, please see: https://esri.github.io/arcgis-python-api

For samples and guides, they are now versioned, and can be found on this page: https://developers.arcgis.com/python/latest/