V101 updates (#75)

* v101 added a topic on masking passwords to the 'working with auth schemes' page

* guide v101 added section showing how to use well-known raster functions

* guide v101 - item2item relationships - added link to REST api showing a table of all possible relationship types

* bug fixes for NYC taxi sample notebook

* added install instructions from pro 1.4

* guide - getting started - name changes

* guide - API overview - updated release notes for v1.0.1, naming changes

* guide - 03 - naming changes

* guide - 04 - naming changes

* guide - 07 - naming changes

* guide - landing page - naming changes

* samples - naming changes

* samples - added credentials

* samples - switched to forward slash. Removed redundant thumbnail images

Author: AtmaMani

guide/01 Getting Started/Install and set up.ipynb

@@ -6,44 +6,55 @@
    "source": [
     "# Install using Conda\n",
     "\n",
-    "The ArcGIS Python API is distributed via conda. Conda is a popular package and environment manager application that helps you install and update packages such as the ArcGIS Python API and their dependencies. To learn more about conda, see the [getting started guide](http://conda.pydata.org/docs/get-started.html) for conda.\n",
+    "The ArcGIS API for Python is distributed via conda. [Conda](http://conda.pydata.org/docs/get-started.html) is a popular package and environment manager application that helps you install and update packages such as the ArcGIS Python API and their dependencies. You can install the API through two main workflows - install through anaconda or install using ArcGIS Pro. Both are outlined below.\n",
     "\n",
-    "## Get Conda\n",
-    "Install the latest version of [Anaconda for Python](https://www.continuum.io/downloads) (for Python 3.5), if you don't already have conda. The ArcGIS Python API requires Python 3.\n",
-    "If you have installed ArcGIS Pro 1.3, you already have conda and you can use that instead of downloading Anaconda.\n",
+    "## Step: 1 Get Conda\n",
+    "Install the latest version of [Anaconda for Python](https://www.continuum.io/downloads) (for Python 3.5), if you don't already have conda. The ArcGIS API for Python requires Python 3.\n",
+    "If you have installed ArcGIS Pro 1.3 or later, you already have conda and you can skip to the next step.\n",
     "\n",
-    "## Install arcgis package\n",
-    "Download and install ArcGIS Python API in your conda environment, using the following command in your terminal. If you are running a Windows OS, you can type this into your command prompt or PowerShell or if you have installed ArcGIS Pro, then into your 'Python Command Prompt' shortcut within the ArcGIS Pro program group in Windows start menu. If you are running a Mac or Linux OS, you can type this into your terminal application.\n",
+    "## Step: 2 Install `arcgis` package\n",
+    "To download and install the API in your conda environment, type the following command in your terminal.\n",
     "\n",
     "    conda install -c esri arcgis\n",
-    "    \n",
-    "In the screen shot below, I am typing this command into the Windows command prompt.\n",
+    "\n",
+    "If you are running a Windows OS, you can type this into your command prompt or PowerShell. If you are running a Mac or Linux OS, you can type this into your terminal application. In the screen shot below, I am typing this command into the Windows command prompt.\n",
     "\n",
     "![install arcgis package](http://esri.github.io/arcgis-python-api/notebooks/nbimages/guide_getstarted_InstallAndSetup_01.PNG)\n",
     "\n",
-    "You can now start using the ArcGIS Python API in your Python IDE of choice, or from the Jupyter Notebook environment.\n",
+    "#### Install using ArcGIS Pro\n",
+    "ArcGIS Pro 1.4 and later gives you a **Python Package Manager** interface that can be used to download and install the ArcGIS API for Python. As shown in the screen shot below, from your Pro backstage, click on the 'Python' tab. Then click on 'Add Packages' button and type `arcgis` into the search bar. You may have to click on the 'refresh' button to ensure you are getting the latest version of the package. Then click 'Install' and accept the terms and conditions.\n",
+    "\n",
+    "![install using ArcGIS Pro](http://esri.github.io/arcgis-python-api/notebooks/nbimages/guide_getstarted_InstallAndSetup_03.PNG)\n",
+    "\n",
+    "If you have installed ArcGIS Pro 1.3, then you can use the **Python Command Prompt** shortcut within the ArcGIS Pro program group in Windows start menu and type the conda install command explained earlier. Depending on how you installed Pro, you might have to start this prompt with elevated privileges.    \n",
+    "\n",
+    "You can now start using the API in your Python IDE of choice, or from the Jupyter Notebook environment.\n",
     "\n",
     "### Upgrade from older arcgis package\n",
     "If you are upgrading from an older version of arcgis package, run the following command in your terminal:\n",
     "\n",
     "    conda upgrade -c esri arcgis\n",
     "\n",
+    "If you are using ArcGIS Pro 1.4 or later to install the API, then as you guessed, you can use the **Update Packages** tab in the screen shot above to update.\n",
+    "\n",
+    "----------------------------\n",
     "### Offline install\n",
     "If you would like to install the API on a machine without internet or, if your workstation is in a disconnected network, you can do so in three steps. \n",
     " * First, install the latest version of [Anaconda for Python](https://www.continuum.io/downloads) (for Python 3.5). It is preferable you install full anaconda and not miniconda. \n",
-    " * Next download the latest version of the API from [Esri's channel on anaconda.org](https://anaconda.org/Esri/arcgis/files) for your OS. For instance, if you are installing on Linux 64-bit, then download the package titled `linux-64/arcgis-1.0-py35_1.tar.bz2` into a known location.\n",
+    " * Next download the latest version of the API from [Esri's channel on anaconda.org](https://anaconda.org/Esri/arcgis/files) for your OS. For instance, if you are installing on Linux 64-bit, then download the package titled `linux-64/arcgis-1.0.1-py35_1.tar.bz2` into a known location.\n",
     " * Run conda from your terminal and install the API using the following command\n",
     "\n",
-    "    `conda install /path_to_package_download_folder/linux-64/arcgis-1.0-py35_1.tar.bz2`\n",
+    "    `conda install /path_to_package_download_folder/linux-64/arcgis-1.0.1-py35_1.tar.bz2`\n",
     "\n",
     "If you find yourself installing the API in multiple machines or, if you need to use miniconda in your workflow, it might be beneficial to set up an offline conda channel. Refer to the [Esri Knowledge Base article for instructions](http://support.esri.com/Products/Developers/scripting-and-automation/arcgis-python-api/1-0#knowledge-base).\n",
     "\n",
+    "-------------------------------\n",
     "## Start jupyter notebook\n",
     "To use the API in the Jupyter Notebook environment, use the following command in your terminal:\n",
     "\n",
     "    jupyter notebook\n",
     "\n",
-    "Refer to this doc for more help on [how to use the notebook environment](https://developers.arcgis.com/python/guide/Using-the-Jupyter-Notebook-environment/)\n",
+    "Refer to this doc for more help on [how to use the notebook environment](https://developers.arcgis.com/python/guide/using-the-jupyter-notebook-environment/)\n",
     "\n",
     "## Test your install\n",
     "From the Jupyter Notebook dashboard, create a new Python 3 notebook and type these lines of code:\n",

guide/01 Getting Started/System requirements.ipynb

@@ -6,16 +6,13 @@
    "source": [
     "# System requirements\n",
     "\n",
-    "In order to use version ArcGIS Python API, you need to use Python 3.\n",
-    "\n",
-    "To use the map widget for Jupyter notebook, you need Python 3.4 or 3.5, and <a href=\"https://github.com/ipython/ipywidgets\">ipywidgets</a> version 5.1.5 or newer.\n",
-    "The conda installer for the arcgis package installs these dependencies."
+    "In order to use version ArcGIS API for Python, you need Python 3.5 or later."
    ]
   }
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python [default]",
+   "display_name": "Python 3",
    "language": "python",
    "name": "python3"
   },

guide/01 Getting Started/Using the API.ipynb

@@ -8,7 +8,7 @@
    "source": [
     "# Using The API\n",
     "\n",
-    "The GIS object is the most important object when working with the Arcgis Python API. The GIS object represents the online GIS you are working with, be it ArcGIS Online or an ArcGIS Portal. You use the GIS object to consume and publish GIS content and administrators may use it to manage GIS users, groups and datastores. The GIS object also includes a number of tools, including spatial analysis tools, big data analytics tools, raster analytics tools as well as helper services such as geocoding and geometry to help in your workflows."
+    "The GIS object is the most important object when working with the ArcGIS API for Python. The GIS object represents the online GIS you are working with, be it ArcGIS Online or a Portal for ArcGIS. You use the GIS object to consume and publish GIS content and administrators may use it to manage GIS users, groups and datastores. The GIS object also includes a number of tools, including spatial analysis tools, big data analytics tools, raster analytics tools as well as helper services such as geocoding and geometry to help in your workflows."
    ]
   },
   {
@@ -115,7 +115,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "The Arcgis Python API is integrated with Jupyter Notebook to make it easy to visualize and interact with GIS resources. The user object has a rich representation that can be queried like this:"
+    "The ArcGIS API for Python is integrated with Jupyter Notebook to make it easy to visualize and interact with GIS resources. The user object has a rich representation that can be queried like this:"
    ]
   },
   {

guide/01 Getting Started/Using the Jupyter Notebook environment.ipynb

@@ -15,7 +15,7 @@
    "source": [
     "## Starting the Jupyter Notebook environment\n",
     "\n",
-    "Once conda and the ArcGIS Python API is [installed](https://developers.arcgis.com/python/guide/Install-and-set-up), you can start the Jupyter Notebook environment by typing the following command in your terminal.\n",
+    "Once conda and the ArcGIS API for Python is [installed](https://developers.arcgis.com/python/guide/Install-and-set-up), you can start the Jupyter Notebook environment by typing the following command in your terminal.\n",
     "\n",
     "    jupyter notebook\n",
     "\n",
@@ -33,7 +33,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "If you installed the ArcGIS Python API in a conda **environment** other than root (which is the default), you need to `activate` that environment before starting the Jupyter Notebook. For more information on the benefits of using environments and how to create and manage them, refer to this [official documentation page](http://conda.pydata.org/docs/using/envs.html).\n",
+    "If you installed the ArcGIS API for Python in a conda **environment** other than root (which is the default), you need to `activate` that environment before starting the Jupyter Notebook. For more information on the benefits of using environments and how to create and manage them, refer to this [official documentation page](http://conda.pydata.org/docs/using/envs.html).\n",
     "\n",
     "If you are running a sample notebook for the API, you need to 'cd' into the directory where you [downloaded the samples](https://github.com/Esri/arcgis-python-api/releases/tag/v0.3-beta). In the example above, the samples have been downloaded and extracted into c:\\code directory.\n",
     "\n",
@@ -97,7 +97,7 @@
  "metadata": {
   "anaconda-cloud": {},
   "kernelspec": {
-   "display_name": "Python [default]",
+   "display_name": "Python 3",
    "language": "python",
    "name": "python3"
   },

guide/02 API Overview/Overview of the ArcGIS Python API.ipynb renamed to guide/02 API Overview/Overview of the ArcGIS API for Python.ipynb

@@ -4,14 +4,14 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Overview of the ArcGIS Python API\n",
+    "# Overview of the ArcGIS API for Python\n",
     "\n",
-    "The ArcGIS Python API is a powerful, modern and easy to use Pythonic library to perform GIS visualization and analysis, spatial data management and GIS system administration tasks that can run both interactively, and using scripts.\n",
+    "The ArcGIS API for Python is a powerful, modern and easy to use Pythonic library to perform GIS visualization and analysis, spatial data management and GIS system administration tasks that can run both interactively, and using scripts.\n",
     "\n",
     "## A Pythonic GIS API\n",
-    "The ArcGIS Python API provides a pythonic representation of a GIS. A pythonic API is one which corresponds to Python best practices in its design and uses standard Python constructs and data structures with clean, readable idioms. The API makes it easy and natural for a Python programmer to use ArcGIS, and conversely, an ArcGIS user to script and automate their GIS.\n",
+    "The ArcGIS API for Python provides a pythonic representation of a GIS. A pythonic API is one which corresponds to Python best practices in its design and uses standard Python constructs and data structures with clean, readable idioms. The API makes it easy and natural for a Python programmer to use ArcGIS, and conversely, an ArcGIS user to script and automate their GIS.\n",
     "\n",
-    "The ArcGIS Python API is implemented using the online and on-premises web GIS platform provided by ArcGIS Online and ArcGIS Enterprise respectively. The API has Python modules, classes, functions, and types for managing and working with elements of the ArcGIS platform information model."
+    "The ArcGIS API for Python is implemented using the online and on-premises web GIS platform provided by ArcGIS Online and ArcGIS Enterprise respectively. The API has Python modules, classes, functions, and types for managing and working with elements of the ArcGIS platform information model."
    ]
   },
   {
@@ -87,7 +87,7 @@
  "metadata": {
   "anaconda-cloud": {},
   "kernelspec": {
-   "display_name": "Python [default]",
+   "display_name": "Python 3",
    "language": "python",
    "name": "python3"
   },

guide/02 API Overview/Release notes.ipynb

@@ -4,6 +4,16 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
+    "# What's new in version 1.0.1\n",
+    "Version 1.0.1 is a bug fix release. Following are some of the bugs that were resolved:\n",
+    "\n",
+    "* BUG-000101507 gis.groups.search returns incorrect results if the User is an owner of more than 100 groups.\n",
+    "* Enabled building initial cache when publishing vector tile packages\n",
+    "* Fixed bug in creating new users on Portal 10.5 or newer\n",
+    "* Fix to ignore values like size of -1 when initializing item objects\n",
+    "* Reorder batch geocoding results to match input array\n",
+    "\n",
+    "\n",
     "# What's new in version 1.0.0\n",
     "\n",
     "Ever since we released the public beta versions, your response to this API has been phenomenal. Since the last release of beta 3, the API went through a redesign phase. We took a critical look at the previous design and evaluated it against the ease of use, extensibility and our original goal of developing a Pythonic API for GIS. The result is this new design, a design that simply does not contour to the implementation logic, but efficiently abstracts it, ensuring the simplicity and beauty of the programming language prevails.\n",

guide/03 The GIS/Accessing and creating content.ipynb

@@ -2038,14 +2038,14 @@
    "metadata": {},
    "source": [
     "## Summary\n",
-    "Thus, in this guide you observed how the `gis` module can be used to create new content and search for existing ones. Head over to the guide on [managing-your-content](/managing-your-content) next. When combined into a script, the ArcGIS Python API becomes a powerful tool to automate your GIS content creation and management tasks."
+    "Thus, in this guide you observed how the `gis` module can be used to create new content and search for existing ones. Head over to the guide on [managing-your-content](/managing-your-content) next. When combined into a script, the ArcGIS API for Python becomes a powerful tool to automate your GIS content creation and management tasks."
    ]
   }
  ],
  "metadata": {
   "anaconda-cloud": {},
   "kernelspec": {
-   "display_name": "Python [default]",
+   "display_name": "Python 3",
    "language": "python",
    "name": "python3"
   },

guide/03 The GIS/Managing your content.ipynb

@@ -769,6 +769,13 @@
     "webmap_item.dependent_to()"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The table in [this documentation](http://resources.arcgis.com/en/help/arcgis-rest-api/index.html#/Relationship_types/02r3000000mm000000/) gives you the list of all supported relationship types that can exist between two items in your GIS."
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -919,7 +926,7 @@
  "metadata": {
   "anaconda-cloud": {},
   "kernelspec": {
-   "display_name": "Python [default]",
+   "display_name": "Python 3",
    "language": "python",
    "name": "python3"
   },

guide/03 The GIS/Using the GIS.ipynb

@@ -8,7 +8,7 @@
    "source": [
     "# Using the GIS \n",
     "\n",
-    "The `GIS` object in the `gis` module is the most important object when working with the Arcgis Python API. The GIS object represents the GIS you are working with, be it ArcGIS Online or an instance of ArcGIS Enterprise. You use the GIS object to consume and publish GIS content and administrators may use it to manage GIS users, groups and datastores. This object becomes your entry point in your Python script when using the API."
+    "The `GIS` object in the `gis` module is the most important object when working with the ArcGIS API for Python. The GIS object represents the GIS you are working with, be it ArcGIS Online or an instance of ArcGIS Enterprise. You use the GIS object to consume and publish GIS content and administrators may use it to manage GIS users, groups and datastores. This object becomes your entry point in your Python script when using the API."
    ]
   },
   {
@@ -33,7 +33,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "To create the GIS object, we pass in the url and our login credentials:"
+    "To create the GIS object, we pass in the url and our login credentials as shown below:"
    ]
   },
   {
@@ -44,7 +44,7 @@
    },
    "outputs": [],
    "source": [
-    "gis = GIS(\"https://yourorg.arcgis.com\", \"username\", \"password\")"
+    "gis = GIS(\"https://www.arcgis.com\", \"arcgis_python\", \"P@ssword123\")"
    ]
   },
   {
@@ -133,7 +133,7 @@
    "metadata": {},
    "source": [
     "## Rich IDE experience with Jupyter notebooks\n",
-    "The Arcgis Python API is integrated with Jupyter Notebook to make it easy to visualize and interact with GIS resources. The `user` object has a rich representation that can be queried like this:"
+    "The ArcGIS API for Python is integrated with Jupyter Notebook to make it easy to visualize and interact with GIS resources. The `user` object has a rich representation that can be queried like this:"
    ]
   },
   {
@@ -607,7 +607,7 @@
  "metadata": {
   "anaconda-cloud": {},
   "kernelspec": {
-   "display_name": "Python [default]",
+   "display_name": "Python 3",
    "language": "python",
    "name": "python3"
   },