Merge pull request #1795 from jyaistMap/master

Merging new samples and guides for 2.3 release into master

guide/01-getting-started/install-and-set-up.ipynb

@@ -290,24 +290,24 @@
  "source": [
  "## Install in Google Colaboratory\n",
  "\n",
- "[Google Colab](https://colab.research.google.com/) is a Google-hosted Jupyter notebook service that allows a user to access their notebooks from anywhere by storing them in [Google Drive](https://drive.google.com/). It requires no setup beyond creating a Google account, and provides free computing resources, including cloud-based GPUs. To learn more, refer to the [FAQ](https://research.google.com/colaboratory/faq.html) or [tutorial](https://colab.research.google.com/drive/16pBJQePbqkz3QFV54L4NIkOn1kwpuRrj).\n",
+ "[Google Colab](https://colab.research.google.com/) is a Google-hosted Jupyter notebook service that allows a user to access their notebooks from anywhere by storing them in [Google Drive](https://drive.google.com/). It requires no setup beyond creating a Google account, and provides free computing resources, including cloud-based GPUs. To learn more, refer to the [FAQ](https://research.google.com/colaboratory/faq.html) or [tutorial](https://colab.research.google.com/drive/16pBJQePbqkz3QFV54L4NIkOn1kwpuRrj). Colab is a very convenient platform for ArcGIS administration and management, as it allows a user to run scripts from wherever they have access to a Google account.\n",
  "\n",
- "Google Colab runs in a cloud virtual machine that uses [Ubuntu](https://ubuntu.com), meaning that it can process bash commands in addition to Python logic. Any command with a `!` in front of it will be treated as if it were entered on the command line. This means that the ArcGIS API for Python can be installed with `pip`, provided that a small Colab-specific dependency detail is first taken care of.\n",
+ "Google Colab runs in a cloud virtual machine that uses [Ubuntu](https://ubuntu.com), meaning that it can process bash commands in addition to Python logic. Any command with a `!` in front of it will be treated as if it were entered on the command line. This means that the ArcGIS API for Python can be installed with `pip`.\n",
  "\n",
  "Follow the steps below to install:\n",
  "\n",
  "* If you have not already done so, register an account with Google and open a new Colab notebook.\n",
  "\n",
- "* Add an empty code cell, and run `!sudo apt-get install libkrb5-dev`. This takes care of the dependency issue, allowing `pip` to complete an install of gssapi, which otherwise fails.\n",
- "\n",
- "* Add another cell and run `!pip install arcgis`.\n",
+ "* Add a cell and run `!pip install arcgis`.\n",
  " - Note: if your account has already been working on a notebook (even a separate one), it may prompt you to restart your runtime in order for this to work. This well reset your environment variables without altering any of your code, allowing you to re-run these commands and install successfully.\n",
  "\n",
- "* You can confirm the installation by running `!pip list`. The list should include arcgis along with all of the other packages found in a normal install.\n",
+ "* You can confirm the installation by running `!pip list`. The list should include arcgis along with all of the proper dependencies found in a normal arcgis install.\n",
+ "\n",
+ "* Run `import arcgis` to confirm that it works properly.\n",
  "\n",
- "Currently, Google Colab is not readily compatible with the ArcGIS mapping widget. However, Colab is a very convenient platform for ArcGIS administration and management, as it allows a user to run scripts from wherever they have access to a Google account.\n",
+ "Currently, Google Colab is not readily compatible with the ArcGIS mapping widget, but may work with some functions that return iFrames, such as the `WebExperience.preview()` method. To enable these widgets (or any 3rd-party widget) in Colab, run `from google.colab import output` followed by `output.enable_custom_widget_manager()`. \n",
  "\n",
- ">Note: At the time of writing this, this installation process works for the default version of Python that comes with Colab, 3.7.13. Functionality with other versions has not yet been confirmed."
+ ">Note: At the time of writing this, this installation process works for the default version of Python that comes with Colab, 3.10.12. This means that only ArcGIS 2.2.0 and higher can be installed, as prior versions are not compatible with Python 3.10+. Downgrading the Python version in Colab is possible, but may interfere with other dependencies needed to run ArcGIS."
  ]
  },
  {
@@ -564,7 +564,7 @@
  ],
  "metadata": {
  "kernelspec": {
- "display_name": "Python 3",
+ "display_name": "Python 3 (ipykernel)",
  "language": "python",
  "name": "python3"
  },
@@ -578,7 +578,7 @@
  "name": "python",
  "nbconvert_exporter": "python",
  "pygments_lexer": "ipython3",
- "version": "3.9.11"
+ "version": "3.9.16"
  },
  "toc": {
  "base_numbering": 1,