Merge pull request #515 from Esri/ncastle/readme-updates

Update readmes for sample changes

src/Android/README.md

@@ -109,7 +109,7 @@ Creating buffers is a core concept in GIS proximity analysis, allowing you to vi
 
 * [Buffer list](Xamarin.Android/Samples/Geometry/BufferList)
 
-This sample demonstrates how to use the GeometryEngine.Buffer to generate one or more polygon from a series of input geometries and matching series of buffer distances. The option to union all the resulting buffer(s) is provided.
+This sample demonstrates how to use a planar (Euclidean) buffer operation by calling `GeometryEngine.Buffer` to generate one or more polygons from a collection of input geometries and a corresponding collection of buffer distances. The result polygons can be returned as individual geometries or unioned into a single polygon output.
 
 * [Clip geometry](Xamarin.Android/Samples/Geometry/ClipGeometry)
 
@@ -331,6 +331,10 @@ This sample demonstrates how to create an `ImageServiceRaster`, fetch the `Rende
 
 This sample demonstrates how to use an RGB renderer on a raster layer. An RGB renderer is used to adjust the color bands of a multi-spectral image.
 
+* [Scene layer selection](Xamarin.Android/Samples/Layers/SceneLayerSelection)
+
+This sample demonstrates how to identify geoelements in a scene layer.
+
 * [Show labels on layer](Xamarin.Android/Samples/Layers/ShowLabelsOnLayer)
 
 This sample demonstrates how to show labels on a feature layer
@@ -501,6 +505,20 @@ This sample demonstrates how you can use the LocatorTask API to geocode an addre
 
 This sample demonstrates how to use geocode functionality to search for points of interest, around a location or within an extent.
 
+## Security
+
+* [ArcGIS token challenge](Xamarin.Android/Samples/Security/TokenSecuredChallenge)
+
+This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server.
+
+* [ArcGIS token with a known user](Xamarin.Android/Samples/Security/TokenSecuredKnownUser)
+
+This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server.
+
+* [Authenticate with OAuth](Xamarin.Android/Samples/Security/OAuth)
+
+This sample demonstrates how to authenticate with ArcGIS Online (or your own portal) using OAuth2 to access a secure web map (or the secured layers it contains). Accessing secured items requires a login on the portal (an ArcGIS Online account, for example).
+
 ## Symbology
 
 * [Distance composite symbol](Xamarin.Android/Samples/Symbology/UseDistanceCompositeSym)
@@ -527,9 +545,3 @@ This sample demonstrates how to create a simple renderer and add it to a graphic
 
 This sample demonstrate how to use a unique value renderer to style different features in a feature layer with different symbols. Features do not have a symbol property for you to set, renderers should be used to define the symbol for features in feature layers. The unique value renderer allows for separate symbols to be used for features that have specific attribute values in a defined field.
 
-## Tutorial
-
-* [Author, edit, and save a map](Xamarin.Android/Samples/Tutorial/AuthorEditSaveMap)
-
-This sample demonstrates how to author and save a map as an ArcGIS portal item (web map). It is also the solution to the [Author, edit, and save maps to your portal tutorial](https://developers.arcgis.com/net/latest/android/guide/author-edit-and-save-maps-to-your-portal.htm). Saving a map to arcgis.com requires an ArcGIS Online login.
-

src/Android/Xamarin.Android/Samples/Layers/SceneLayerSelection/readme.md

@@ -0,0 +1,9 @@
+# Scene layer selection
+
+This sample demonstrates how to identify geoelements in a scene layer.
+
+<img src="SceneLayerSelection.jpg" width="350"/>
+
+## Instructions
+
+Tap/Click on a building in the scene layer to identify it.

src/Android/Xamarin.Android/Samples/Layers/WmsIdentify/README.md

@@ -6,4 +6,4 @@ This sample demonstrates how to identify WMS features and display the associated
 
 ## Instructions
 
-Tap or click on a feature. A callout appears with the returned content for the WMS feature. Note that due to the nature of the WMS service implementation, an empty result is shown when there is no result; an application might inspect the HTML to determine if the HTML actually contains a feature.
+Tap to identify a feature. Note: the service returns HTML regardless of whether there was an identify result. See the Forms implementation for an example heuristic for identifying empty results.

src/Forms/README.md

@@ -109,7 +109,7 @@ Creating buffers is a core concept in GIS proximity analysis, allowing you to vi
 
 * [Buffer list](Shared/Samples/Geometry/BufferList)
 
-This sample demonstrates how to use the GeometryEngine.Buffer to generate one or more polygon from a series of input geometries and matching series of buffer distances. The option to union all the resulting buffer(s) is provided.
+This sample demonstrates how to use a planar (Euclidean) buffer operation by calling `GeometryEngine.Buffer` to generate one or more polygons from a collection of input geometries and a corresponding collection of buffer distances. The result polygons can be returned as individual geometries or unioned into a single polygon output.
 
 * [Clip geometry](Shared/Samples/Geometry/ClipGeometry)
 
@@ -331,6 +331,10 @@ This sample demonstrates how to create an `ImageServiceRaster`, fetch the `Rende
 
 This sample demonstrates how to use an RGB renderer on a raster layer. An RGB renderer is used to adjust the color bands of a multi-spectral image.
 
+* [Scene layer selection](Shared/Samples/Layers/SceneLayerSelection)
+
+This sample demonstrates how to identify geoelements in a scene layer.
+
 * [Show labels on layer](Shared/Samples/Layers/ShowLabelsOnLayer)
 
 This sample demonstrates how to show labels on a feature layer
@@ -501,6 +505,20 @@ This sample demonstrates how you can use the LocatorTask API to geocode an addre
 
 This sample demonstrates how to use geocode functionality to search for points of interest, around a location or within an extent.
 
+## Security
+
+* [ArcGIS token challenge](Shared/Samples/Security/TokenSecuredChallenge)
+
+This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server.
+
+* [ArcGIS token with a known user](Shared/Samples/Security/TokenSecuredKnownUser)
+
+This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server.
+
+* [Authenticate with OAuth](Shared/Samples/Security/OAuth)
+
+This sample demonstrates how to authenticate with ArcGIS Online (or your own portal) using OAuth2 to access a secure web map (or the secured layers it contains). Accessing secured items requires a login on the portal (an ArcGIS Online account, for example).
+
 ## Symbology
 
 * [Distance composite symbol](Shared/Samples/Symbology/UseDistanceCompositeSym)
@@ -527,9 +545,3 @@ This sample demonstrate how to use a unique value renderer to style different fe
 
 This sample demonstrates how to create a simple renderer and add it to a graphics overlay. Renderers define the symbology for all graphics in a graphics overlay (unless they are overridden by setting the symbol directly on the graphic). Simple renderers can also be defined on feature layers using the same code.
 
-## Tutorial
-
-* [Author, edit, and save a map](Shared/Samples/Tutorial/AuthorEditSaveMap)
-
-This sample demonstrates how to author and save a map as an ArcGIS portal item (web map). It is also the solution to the [Author, edit, and save maps to your portal tutorial](https://developers.arcgis.com/net/latest/forms/guide/author-edit-and-save-maps-to-your-portal.htm). Saving a map to arcgis.com requires an ArcGIS Online login.
-

src/Forms/Shared/Samples/Layers/WmsIdentify/README.md

@@ -6,4 +6,4 @@ This sample demonstrates how to identify WMS features and display the associated
 
 ## Instructions
 
-Tap or click on a feature. A callout appears with the returned content for the WMS feature. Note: the service returns HTML regardless of whether there was an identify result. The sample uses a heuristic to hide empty results.
+Tap to identify a feature. Note: the service returns HTML regardless of whether there was an identify result. The sample uses a heuristic to not show empty results.

src/UWP/ArcGISRuntime.UWP.Viewer/Samples/Layers/WmsIdentify/README.md

@@ -6,4 +6,4 @@ This sample demonstrates how to identify WMS features and display the associated
 
 ## Instructions
 
-Tap or click on a feature. A callout appears with the returned content for the WMS feature. Note: the service returns HTML regardless of whether there was an identify result. The sample uses a heuristic to hide empty results.
+Tap a feature to identify. Note: the service returns HTML regardless of whether there was an identify result. The sample uses a heuristic to hide empty results.

src/UWP/README.md

@@ -109,7 +109,7 @@ Creating buffers is a core concept in GIS proximity analysis, allowing you to vi
 
 * [Buffer list](ArcGISRuntime.UWP.Viewer/Samples/Geometry/BufferList)
 
-This sample demonstrates how to use the GeometryEngine.Buffer to generate one or more polygon from a series of input geometries and matching series of buffer distances. The option to union all the resulting buffer(s) is provided.
+This sample demonstrates how to use a planar (Euclidean) buffer operation by calling `GeometryEngine.Buffer` to generate one or more polygons from a collection of input geometries and a corresponding collection of buffer distances. The result polygons can be returned as individual geometries or unioned into a single polygon output.
 
 * [Clip geometry](ArcGISRuntime.UWP.Viewer/Samples/Geometry/ClipGeometry)
 
@@ -327,6 +327,10 @@ This sample demonstrates how to create an `ImageServiceRaster`, fetch the `Rende
 
 This sample demonstrates how to use an RGB renderer on a raster layer. An RGB renderer is used to adjust the color bands of a multi-spectral image.
 
+* [Scene layer selection](ArcGISRuntime.UWP.Viewer/Samples/Layers/SceneLayerSelection)
+
+This sample demonstrates how to identify geoelements in a scene layer.
+
 * [Show labels on layer](ArcGISRuntime.UWP.Viewer/Samples/Layers/ShowLabelsOnLayer)
 
 This sample demonstrates how to show labels on a feature layer
@@ -497,6 +501,20 @@ This sample demonstrates how you can use the LocatorTask API to geocode an addre
 
 This sample demonstrates how to use geocode functionality to search for points of interest, around a location or within an extent.
 
+## Security
+
+* [ArcGIS token challenge](ArcGISRuntime.UWP.Viewer/Samples/Security/TokenSecuredChallenge)
+
+This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server.
+
+* [ArcGIS token with a known user](ArcGISRuntime.UWP.Viewer/Samples/Security/TokenSecuredKnownUser)
+
+This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server.
+
+* [Authenticate with OAuth](ArcGISRuntime.UWP.Viewer/Samples/Security/OAuth)
+
+This sample demonstrates how to authenticate with ArcGIS Online (or your own portal) using OAuth2 to access a secure web map (or the secured layers it contains). Accessing secured items requires a login on the portal (an ArcGIS Online account, for example).
+
 ## Symbology
 
 * [Distance composite symbol](ArcGISRuntime.UWP.Viewer/Samples/Symbology/UseDistanceCompositeSym)
@@ -523,9 +541,3 @@ This sample demonstrate how to use a unique value renderer to style different fe
 
 This sample demonstrates how to create a simple renderer and add it to a graphics overlay. Renderers define the symbology for all graphics in a graphics overlay (unless they are overridden by setting the symbol directly on the graphic). Simple renderers can also be defined on feature layers using the same code.
 
-## Tutorial
-
-* [Author, edit, and save a map](ArcGISRuntime.UWP.Viewer/Samples/Tutorial/AuthorEditSaveMap)
-
-This sample demonstrates how to author and save a map as an ArcGIS portal item (web map). It is also the solution to the [Author, edit, and save maps to your portal tutorial](https://developers.arcgis.com/net/latest/uwp/guide/author-edit-and-save-maps-to-your-portal.htm). Saving a map to arcgis.com requires an ArcGIS Online login.
-

src/WPF/ArcGISRuntime.WPF.Viewer/Samples/Layers/WmsIdentify/README.md

@@ -6,4 +6,4 @@ This sample demonstrates how to identify WMS features and display the associated
 
 ## Instructions
 
-Tap or click on a feature. A callout appears with the returned content for the WMS feature. Note: the service returns HTML regardless of whether there was an identify result. The sample uses a heuristic to hide empty results.
+Tap a feature to identify. Note: the service returns HTML regardless of whether there was an identify result. The sample uses a heuristic to hide empty results.

src/WPF/README.md

@@ -109,7 +109,7 @@ Creating buffers is a core concept in GIS proximity analysis, allowing you to vi
 
 * [Buffer list](ArcGISRuntime.WPF.Viewer/Samples/Geometry/BufferList)
 
-This sample demonstrates how to use the GeometryEngine.Buffer to generate one or more polygon from a series of input geometries and matching series of buffer distances. The option to union all the resulting buffer(s) is provided.
+This sample demonstrates how to use a planar (Euclidean) buffer operation by calling `GeometryEngine.Buffer` to generate one or more polygons from a collection of input geometries and a corresponding collection of buffer distances. The result polygons can be returned as individual geometries or unioned into a single polygon output.
 
 * [Clip geometry](ArcGISRuntime.WPF.Viewer/Samples/Geometry/ClipGeometry)
 
@@ -327,6 +327,10 @@ This sample demonstrates how to create an `ImageServiceRaster`, fetch the `Rende
 
 This sample demonstrates how to use an RGB renderer on a raster layer. An RGB renderer is used to adjust the color bands of a multi-spectral image.
 
+* [Scene layer selection](ArcGISRuntime.WPF.Viewer/Samples/Layers/SceneLayerSelection)
+
+This sample demonstrates how to identify geoelements in a scene layer.
+
 * [Show labels on layer](ArcGISRuntime.WPF.Viewer/Samples/Layers/ShowLabelsOnLayer)
 
 This sample demonstrates how to show labels on a feature layer
@@ -425,6 +429,10 @@ This sample demonstrates loading a webmap in a map from a Uri.
 
 This sample demonstrates how to open a mobile map from a map package.
 
+* [Open scene (Portal item)](ArcGISRuntime.WPF.Viewer/Samples/Map/OpenScene)
+
+This sample demonstrates how to open a scene from a Portal item. Just like Web Maps are the ArcGIS format for maps, Web Scenes are the ArcGIS format for scenes. These scenes can be stored in ArcGIS Online or Portal.
+
 * [Search a portal for maps](ArcGISRuntime.WPF.Viewer/Samples/Map/SearchPortalMaps)
 
 This sample demonstrates searching a portal for web maps and loading them in the map view. You can search ArcGIS Online public web maps using tag values or browse the web maps in your account. OAuth is used to authenticate with ArcGIS Online to access items in your account.
@@ -519,6 +527,20 @@ This sample demonstrates how you can use the LocatorTask API to geocode an addre
 
 This sample demonstrates how to use geocode functionality to search for points of interest, around a location or within an extent.
 
+## Security
+
+* [ArcGIS token challenge](ArcGISRuntime.WPF.Viewer/Samples/Security/TokenSecuredChallenge)
+
+This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server.
+
+* [ArcGIS token with a known user](ArcGISRuntime.WPF.Viewer/Samples/Security/TokenSecuredKnownUser)
+
+This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server.
+
+* [Authenticate with OAuth](ArcGISRuntime.WPF.Viewer/Samples/Security/OAuth)
+
+This sample demonstrates how to authenticate with ArcGIS Online (or your own portal) using OAuth2 to access a secure web map (or the secured layers it contains). Accessing secured items requires a login on the portal (an ArcGIS Online account, for example).
+
 ## Symbology
 
 * [Distance composite symbol](ArcGISRuntime.WPF.Viewer/Samples/Symbology/UseDistanceCompositeSym)
@@ -545,9 +567,3 @@ This sample demonstrate how to use a unique value renderer to style different fe
 
 This sample demonstrates how to create a simple renderer and add it to a graphics overlay. Renderers define the symbology for all graphics in a graphics overlay (unless they are overridden by setting the symbol directly on the graphic). Simple renderers can also be defined on feature layers using the same code.
 
-## Tutorial
-
-* [Author, edit, and save a map](ArcGISRuntime.WPF.Viewer/Samples/Tutorial/AuthorEditSaveMap)
-
-This sample demonstrates how to author and save a map as an ArcGIS portal item (web map). It is also the solution to the [Author, edit, and save maps to your portal tutorial](https://developers.arcgis.com/net/latest/wpf/guide/author-edit-and-save-maps-to-your-portal.htm). Saving a map to arcgis.com requires an ArcGIS Online login.
-