V101 bad links (#81)

* Fix wrong location in comment

* Merge dev branch into master for 0.2 Beta and Holistic Testing (#24)

* Updated publishing samples to reflect changes made to source code

* Updated Publihing SDs, shp, csv samples to reflect latest API changes

* Publisher sample updates - added samples for web maps and web scene (#3)

* Updated notebook title to match filename

* Added a new sample to showcase publishing web maps and web scenes

* Fixed credentials

* Updated sample titled "Using and updating GIS content" (#4)

* Updated notebook title to match filename

* Added a new sample to showcase publishing web maps and web scenes

* Fixed credentials

* Updated the sample with additional examples

* Fixed credentials

* Added an example for line featuers. Added some text explaining what smart mapping is

* Additional widgets to minimize scrolling. Fixed geocoder usage following API update

* Updated geocoder usage to match API updates

* Updated the sample to match gp service update. Added a bit more text explaining the usage of gp tools (#12)

* Minor - updated sample to search for desired item to add instead of a fixed index (#13)

* GIS analysts - sample illustrating spatial analysis using ArcGIS Python API (#14)

* Initial commit

* Furnished the sample with spatial analysis examples

* Fixes for API changes. Added summary text and elaborated a few steps (#15)

* new sample to showcase big data anlaysis using NYC taxi example (#16)

* Updated hurricane tracks sample to match API changes (#17)

* Updated hurricane tracks sample to match API changes and added descriptive text

* updated credentials

* Updated sample to match API changes, added explanatory text (#19)

* clean up sample (#18)

* clean up sample (#20)

* Remove usage statistics notebook as the API isnt available

This requires work on the portal backend as well as it does not yet
support ASM.

* bug fixes and added descriptive text (#22)

* synced raster product sample in 05 Content Publishers folder to match that in 04 GIS Analysts and Data Scientists (#21)

Thanks, @AtmaMani

* Updated Overview page - updated sample TOC (#23)

* doc updates

* apidoc update for 0.2 beta release

* updated install instructions

* Updated samples download link to point to v0.2-beta release (#25)

* fixed wrong import

* fixed execution count

* Use ReadTheDocs theme

* apache 2.0 license specified

* api doc updates

* gis doc update

* clean up doc

* bug fixes in clone portal sample

* 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

* apidoc update

* V101 publish packages & clone samples (#77)

* content and notebook demonstrating publishing of packages as web layers

* added sample showing how to publish packages as web layers

* updated clone portals sample

* minor doc update - gis.map (#79)

* content and notebook demonstrating publishing of packages as web layers

* added sample showing how to publish packages as web layers

* updated clone portals sample

* fix for #76

* v101 fixed bad links

* fixed more links to become relative links

* updated install instructions

Author: AtmaMani

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

@@ -9,15 +9,15 @@
     "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",
     "## 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",
+    "Install the latest version of [Anaconda for Python](https://www.continuum.io/downloads) (for Python 3x), if you don't already have conda. The ArcGIS API for Python requires Python 3.5 or higher.\n",
+    "If you have installed ArcGIS Pro 1.4 or later, you already have conda.\n",
     "\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",
-    "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",
+    "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. The screen shot below shows this command being typed 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",
@@ -26,25 +26,34 @@
     "\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",
+    "Alternately, if you would like to install through the command line, 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",
+    "**Note**: \n",
+    " * ArcGIS API for Python requires Pro 1.4 or later. If you are using Pro 1.3, please upgrade to 1.4 or later. If you cannot upgrade, you can still install the API by creating a new environment in conda with Python 3.5 or higher and install the API in that environment. However, if you follow this approach, you cannot use ArcPy and the API from the same Python environment. Instructions for this approach is below, type them one at a time in the Python Command Prompt:\n",
+    " \n",
+    "         conda create --name my_new_pro_env python=3.6\n",
+    "         activate my_new_pro_env\n",
+    "         conda install -c esri arcgis\n",
+    "     \n",
+    " * You can have both anaconda and ArcGIS Pro installed on the same computer and have the API installed in both. Thus if you have Pro 1.3, you can either install the API by creating a new environment (explained above) or by installing anaconda.\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",
+    "If you are upgrading from an older version of the 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",
+    "If you are using ArcGIS Pro 1.4 or later to install the API, you can use the **Update Packages** tab in the screen shot above to update. An alternate way to upgrade is to use the **Python Command Prompt** and type the above command.\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.1-py35_1.tar.bz2` into a known location.\n",
+    " * First, install the latest version of [Anaconda for Python](https://www.continuum.io/downloads) (for Python 3x). 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.1-py36_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.1-py35_1.tar.bz2`\n",
+    "    `conda install /path_to_package_download_folder/linux-64/arcgis-1.0.1-py36_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",
@@ -63,9 +72,11 @@
     "    my_gis = GIS()\n",
     "    my_gis.map()\n",
     "    \n",
-    "If the installation went through fine, you should see a map come up as shown below:\n",
+    "You should see a map come up as shown below:\n",
+    "\n",
+    "![test your install](http://esri.github.io/arcgis-python-api/notebooks/nbimages/guide_getstarted_InstallAndSetup_02.PNG)\n",
     "\n",
-    "![test your install](http://esri.github.io/arcgis-python-api/notebooks/nbimages/guide_getstarted_InstallAndSetup_02.PNG)"
+    "Next, you can learn more about the API using the [guide](/python/guide/) and try out the [samples](/python/sample-notebooks/)."
    ]
   }
  ],
@@ -85,7 +96,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.6.0"
+   "version": "3.5.2"
   }
  },
  "nbformat": 4,

guide/08 Finding places with Geocoding/Batch Geocoding.ipynb

@@ -313,7 +313,7 @@
     "<a id=\"category-parameter\"></a>\n",
     "### category parameter\n",
     "\n",
-    "A place or address type which can be used to filter batch geocoding results. The parameter supports input of single category values or multiple comma-separated values. See the help topic <a href=\"https://developers.arcgis.com/rest/geocode/api-reference/geocoding-category-filtering.htm\">Category filtering</a> for complete details about the category parameter.\n",
+    "A place or address type which can be used to filter batch geocoding results. The parameter supports input of single category values or multiple comma-separated values. See the help topic <a href=\"/rest/geocode/api-reference/geocoding-category-filtering.htm\">Category filtering</a> for complete details about the category parameter.\n",
     "\n",
     "Example of category filtering with a single category:\n",
     "\n",
@@ -335,7 +335,7 @@
     "\n",
     "Acceptable values include the full country name, the ISO 3166-1 2-digit country code, or the ISO 3166-1 3-digit country code.\n",
     "\n",
-    "A list of supported countries and codes is available <a href=\"https://developers.arcgis.com/rest/geocode/api-reference/geocode-coverage.htm\">here</a>.\n",
+    "A list of supported countries and codes is available <a href=\"/rest/geocode/api-reference/geocode-coverage.htm\">here</a>.\n",
     "\n",
     "Example:\n",
     "\n",
@@ -357,7 +357,7 @@
     "<a id=\"batch-geocoding-output-fields\"></a>\n",
     "### Batch geocoding output fields\n",
     "\n",
-    "When you geocode a list of addresses, the output fields are returned as part of the attributes in the response. See the example JSON response below which shows all of the output fields that are returned for each record from a batch geocode process. The output fields are described <a href=\"https://developers.arcgis.com/rest/geocode/api-reference/geocoding-service-output.htm#ESRI_SECTION1_42D7D3D0231241E9B656C01438209440\">here</a>.\n",
+    "When you geocode a list of addresses, the output fields are returned as part of the attributes in the response. See the example JSON response below which shows all of the output fields that are returned for each record from a batch geocode process. The output fields are described <a href=\"/rest/geocode/api-reference/geocoding-service-output.htm#ESRI_SECTION1_42D7D3D0231241E9B656C01438209440\">here</a>.\n",
     "\n",
     "<a id=\"examples\"></a>\n",
     "## Batch geocoding examples\n",
@@ -593,7 +593,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.5.2"
+   "version": "3.6.0"
   }
  },
  "nbformat": 4,

guide/08 Finding places with Geocoding/Filtering your geocoding results.ipynb

@@ -657,7 +657,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "See the topic <a href=\"https://developers.arcgis.com/rest/geocode/api-reference/geocoding-category-filtering.htm\">Category filtering</a> for complete details."
+    "See the topic <a href=\"/rest/geocode/api-reference/geocoding-category-filtering.htm\">Category filtering</a> for complete details."
    ]
   }
  ],
@@ -677,7 +677,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.5.2"
+   "version": "3.6.0"
   }
  },
  "nbformat": 4,

guide/08 Finding places with Geocoding/Reverse Geocoding.ipynb

@@ -286,7 +286,7 @@
     "\n",
     "Sets the language in which reverse-geocoded addresses are returned. Addresses in many countries are available in more than one language; in these cases the langCode parameter can be used to specify which language should be used for addresses returned by the reverse_geocode() method. This is useful for ensuring that addresses are returned in the expected language by reverse geocoding functionality in an application. For example, a web application could be designed to get the browser language and then pass it as the langCode parameter value in a reverseGeocode request.\n",
     "\n",
-    "See the <a href=\"https://developers.arcgis.com/rest/geocode/api-reference/geocode-coverage.htm#GUID-D61FB53E-32DF-4E0E-A1CC-473BA38A23C0\">table of supported countries</a> for valid language code values in each country. The Two-Digit Language Codes column provides the valid input values for the langCode parameter. Only the two-digit language codes in this column are accepted as valid input; neither three-digit language codes nor full language names can be used with the langCode parameter.\n",
+    "See the <a href=\"/rest/geocode/api-reference/geocode-coverage.htm#GUID-D61FB53E-32DF-4E0E-A1CC-473BA38A23C0\">table of supported countries</a> for valid language code values in each country. The Two-Digit Language Codes column provides the valid input values for the langCode parameter. Only the two-digit language codes in this column are accepted as valid input; neither three-digit language codes nor full language names can be used with the langCode parameter.\n",
     "\n",
     "Note:\n",
     "The language code \"XX\" is a convention used to represent transliterated or transcribed versions of a language.\n",
@@ -451,7 +451,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.5.2"
+   "version": "3.6.0"
   }
  },
  "nbformat": 4,

guide/08 Finding places with Geocoding/Understanding geocoders.ipynb

@@ -34,7 +34,7 @@
     "\n",
     "A GIS includes one or more geocoders. The list of geocoders registered with the GIS can be queried using `get_geocoders()`. This method returns a list of `Geocoder` instances.\n",
     "\n",
-    "In the example below, there is one registered Geocoder with the GIS, that uses the [Esri World Geocoding Service](https://developers.arcgis.com/features/geocoding/) for geocoding:"
+    "In the example below, there is one registered Geocoder with the GIS, that uses the [Esri World Geocoding Service](/features/geocoding/) for geocoding:"
    ]
   },
   {
@@ -463,7 +463,7 @@
    "metadata": {},
    "source": [
     "#### Localized input field names\n",
-    "Developers integrating the geocoder into their application may need to know the appropriate input field names to use for the language and country of their users. This information can be obtained using the 'localizedNames' parameter of the address field. More information on this as well as the 'recognizedNames' parameter is avilable in the <a href=\"https://developers.arcgis.com/rest/geocode/api-reference/geocoding-localized-input-field-names.htm#ESRI_SECTION1_420C0A38D36546EDB1FC114048757B3E\">Foreign language field names (World Geocoding Service)</a> documentation\n",
+    "Developers integrating the geocoder into their application may need to know the appropriate input field names to use for the language and country of their users. This information can be obtained using the 'localizedNames' parameter of the address field. More information on this as well as the 'recognizedNames' parameter is avilable in the <a href=\"/rest/geocode/api-reference/geocoding-localized-input-field-names.htm#ESRI_SECTION1_420C0A38D36546EDB1FC114048757B3E\">Foreign language field names (World Geocoding Service)</a> documentation\n",
     "\n",
     "For example, the code below lists the supported address fields and the corresponding input field names in Hindi:"
    ]
@@ -503,7 +503,7 @@
     "<a id=\"categories-property\"></a>\n",
     "### `Categories` property\n",
     "\t\n",
-    "The 'categories' property can be used to limit result to one or more categories. For example, \"Populated Place\" or \"Scandinavian Food\". Only applies to the World Geocode Service. See <a href=\"https://developers.arcgis.com/rest/geocode/api-reference/geocoding-category-filtering.htm#ESRI_SECTION1_502B3FE2028145D7B189C25B1A00E17B\">Category filtering (World Geocoding Service)</a> for more information.\n",
+    "The 'categories' property can be used to limit result to one or more categories. For example, \"Populated Place\" or \"Scandinavian Food\". Only applies to the World Geocode Service. See <a href=\"/rest/geocode/api-reference/geocoding-category-filtering.htm#ESRI_SECTION1_502B3FE2028145D7B189C25B1A00E17B\">Category filtering (World Geocoding Service)</a> for more information.\n",
     "\n",
     "The following code lists the entire hierarchy of supported category values."
    ]
@@ -1051,7 +1051,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.5.2"
+   "version": "3.6.0"
   }
  },
  "nbformat": 4,

guide/08 Finding places with Geocoding/Understanding the geocode function.ipynb

@@ -608,7 +608,7 @@
     "<a id=\"out-fields-parameter\"></a>\n",
     "### out_fields parameter\n",
     "\n",
-    "The list of fields to be returned in the response. Descriptions for each of these fields are available in the <a href=\"https://developers.arcgis.com/rest/geocode/api-reference/geocoding-service-output.htm#ESRI_SECTION1_42D7D3D0231241E9B656C01438209440\">Output fields section of this document</a>.\n",
+    "The list of fields to be returned in the response. Descriptions for each of these fields are available in the <a href=\"/rest/geocode/api-reference/geocoding-service-output.htm#ESRI_SECTION1_42D7D3D0231241E9B656C01438209440\">Output fields section of this document</a>.\n",
     "\n",
     "The returned address, x/y coordinates of the match location, match score, spatial reference, extent of the output feature, and the addr_type (match level) are returned by default.\n",
     "\n",
@@ -640,7 +640,7 @@
     "\n",
     "ArcGIS Online service credits are deducted from the organization account for each geocode transaction that includes the forStorage parameter with a value of true. Refer to the <a href=\"http://www.esri.com/SOFTWARE/ARCGIS/ARCGISONLINE/CREDITS\">ArcGIS Online service credits overview page</a> for more information on how credits are charged.\n",
     "\n",
-    "To learn more about free and paid geocoding operations, see <a href=\"https://developers.arcgis.com/rest/geocode/api-reference/geocoding-free-vs-paid.htm\">this help topic</a>.\n",
+    "To learn more about free and paid geocoding operations, see <a href=\"/rest/geocode/api-reference/geocoding-free-vs-paid.htm\">this help topic</a>.\n",
     "\n",
     "Example:\n",
     "\n",
@@ -664,7 +664,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.5.2"
+   "version": "3.6.0"
   }
  },
  "nbformat": 4,