Addressed suggestions from code review for 'list transformations by s…

…uitability' sample.

src/Android/Xamarin.Android/Samples/GeometryEngine/ListTransformations/ListTransformations.cs

@@ -57,7 +57,7 @@ protected override void OnCreate(Bundle bundle)
         {
             base.OnCreate(bundle);
 
-            Title = "List transformations";
+            Title = "List transformations by suitability";
 
             // Create the UI.
             CreateLayout();
@@ -176,6 +176,7 @@ private void CreateLayout()
             // Create a new vertical layout for the app UI.
             LinearLayout mainLayout = new LinearLayout(this) { Orientation = Orientation.Vertical };
 
+            // Create a layout for the app tools.
             LinearLayout toolsLayout = new LinearLayout(this) { Orientation = Orientation.Vertical };
             toolsLayout.SetPadding(10, 0, 0, 0);
             toolsLayout.SetMinimumHeight(320);

src/Android/Xamarin.Android/Samples/GeometryEngine/ListTransformations/metadata.json

@@ -2,7 +2,7 @@
   "Name": "List transformations by suitability",
   "SampleName": "ListTransformations",
   "Description": "This sample demonstrates how to use the TransformationCatalog to get a list of available DatumTransformations that can be used to project a Geometry between two different SpatialReferences, and how to use one of the transformations to perform the GeometryEngine.project operation. The TransformationCatalog is also used to set the location of files upon which grid-based transformations depend, and to find the default transformation used for the two SpatialReferences.",
-  "Instructions": "Tap on a listed transformation to reproject the point geometry (shown with a blue square) using the selected transformation. The reprojected geometry will be shown in red. If there are grid-based transformations for which projection engine files are not available locally, these will be shown in gray in the list. The default transformation is shown in bold. To download the additional transformation data, log on to your developers account (http://developers.arcgis.com), click the 'Download APIs' button on the dashboard page, and download the 'Coordinate System Data' archive from the 'Supplemental ArcGIS Runtime Data' tab. Unzip the archive to the 'SampleData' folder.",
+  "Instructions": "Tap on a listed transformation to re-project the point geometry (shown with a blue square) using the selected transformation. The reprojected geometry will be shown in red. If there are grid-based transformations for which projection engine files are not available locally, these will be shown in gray in the list. The default transformation is shown in bold. To download the additional transformation data, log on to your developers account (http://developers.arcgis.com), click the 'Download APIs' button on the dashboard page, and download the 'Coordinate System Data' archive from the 'Supplemental ArcGIS Runtime Data' tab. Unzip the archive to the 'SampleData' sub-folder of the ApplicationData directory, which can be found for each platform at run time with System.Environment.GetFolderPath(System.Environment.SpecialFolder.ApplicationData).",
   "Type": 0,
   "RequiresOnlineConnection": true,
   "RequiresOfflineData": false,

src/Forms/Shared/Samples/GeometryEngine/ListTransformations/ListTransformations.xaml.cs

@@ -150,6 +150,7 @@ private void TransformationsListBox_ItemSelected(object sender, SelectedItemChan
             DatumTransformationListBoxItem selectedListBoxItem = TransformationsListBox.SelectedItem as DatumTransformationListBoxItem;
             if (selectedListBoxItem == null) { return; }
 
+            // Get the datum transformation object from the list box item.
             DatumTransformation selectedTransform = selectedListBoxItem.TransformationObject;
 
             try

src/Forms/Shared/Samples/GeometryEngine/ListTransformations/metadata.json

@@ -2,7 +2,7 @@
   "Name": "List transformations by suitability",
   "SampleName": "ListTransformations",
   "Description": "This sample demonstrates how to use the TransformationCatalog to get a list of available DatumTransformations that can be used to project a Geometry between two different SpatialReferences, and how to use one of the transformations to perform the GeometryEngine.project operation. The TransformationCatalog is also used to set the location of files upon which grid-based transformations depend, and to find the default transformation used for the two SpatialReferences.",
-  "Instructions": "Tap on a listed transformation to reproject the point geometry (shown with a blue square) using the selected transformation. The reprojected geometry will be shown in red. If there are grid-based transformations for which projection engine files are not available locally, these will be shown in gray in the list. The default transformation is shown in bold. To download the additional transformation data, log on to your developers account (http://developers.arcgis.com), click the 'Download APIs' button on the dashboard page, and download the 'Coordinate System Data' archive from the 'Supplemental ArcGIS Runtime Data' tab. Unzip the archive to the 'SampleData' folder.",
+  "Instructions": "Tap on a listed transformation to re-project the point geometry (shown with a blue square) using the selected transformation. The reprojected geometry will be shown in red. If there are grid-based transformations for which projection engine files are not available locally, these will be shown in gray in the list. The default transformation is shown in bold. To download the additional transformation data, log on to your developers account (http://developers.arcgis.com), click the 'Download APIs' button on the dashboard page, and download the 'Coordinate System Data' archive from the 'Supplemental ArcGIS Runtime Data' tab. Unzip the archive to the 'SampleData' sub-folder of the ApplicationData directory, which can be found for each platform at run time with System.Environment.GetFolderPath(System.Environment.SpecialFolder.ApplicationData).",
   "Type": 0,
   "RequiresOnlineConnection": true,
   "RequiresOfflineData": false,

src/UWP/ArcGISRuntime.UWP.Samples/Samples/GeometryEngine/ListTransformations/metadata.json

@@ -2,7 +2,7 @@
   "Name": "List transformations by suitability",
   "SampleName": "ListTransformations",
   "Description": "This sample demonstrates how to use the TransformationCatalog to get a list of available DatumTransformations that can be used to project a Geometry between two different SpatialReferences, and how to use one of the transformations to perform the GeometryEngine.project operation. The TransformationCatalog is also used to set the location of files upon which grid-based transformations depend, and to find the default transformation used for the two SpatialReferences.",
-  "Instructions": "Tap on a listed transformation to reproject the point geometry (shown with a blue square) using the selected transformation. The reprojected geometry will be shown in red. If there are grid-based transformations for which projection engine files are not available locally, these will be shown in gray in the list. The default transformation is shown in bold. To download the additional transformation data, log on to your developers account (http://developers.arcgis.com), click the 'Download APIs' button on the dashboard page, and download the 'Coordinate System Data' archive from the 'Supplemental ArcGIS Runtime Data' tab. Unzip the archive to the 'SampleData' folder.",
+  "Instructions": "Tap on a listed transformation to re-project the point geometry (shown with a blue square) using the selected transformation. The reprojected geometry will be shown in red. If there are grid-based transformations for which projection engine files are not available locally, these will be shown in gray in the list. The default transformation is shown in bold. To download the additional transformation data, log on to your developers account (http://developers.arcgis.com), click the 'Download APIs' button on the dashboard page, and download the 'Coordinate System Data' archive from the 'Supplemental ArcGIS Runtime Data' tab. Unzip the archive to the 'SampleData' sub-folder of the ApplicationData directory, which can be found for each platform at run time with System.Environment.GetFolderPath(System.Environment.SpecialFolder.ApplicationData).",
   "Type": 0,
   "RequiresOnlineConnection": true,
   "RequiresOfflineData": false,

src/WPF/ArcGISRuntime.WPF.Samples/Samples/GeometryEngine/ListTransformations/metadata.json

@@ -2,7 +2,7 @@
   "Name": "List transformations by suitability",
   "SampleName": "ListTransformations",
   "Description": "This sample demonstrates how to use the TransformationCatalog to get a list of available DatumTransformations that can be used to project a Geometry between two different SpatialReferences, and how to use one of the transformations to perform the GeometryEngine.project operation. The TransformationCatalog is also used to set the location of files upon which grid-based transformations depend, and to find the default transformation used for the two SpatialReferences.",
-  "Instructions": "Tap on a listed transformation to reproject the point geometry (shown with a blue square) using the selected transformation. The reprojected geometry will be shown in red. If there are grid-based transformations for which projection engine files are not available locally, these will be shown in gray in the list. The default transformation is shown in bold. To download the additional transformation data, log on to your developers account (http://developers.arcgis.com), click the 'Download APIs' button on the dashboard page, and download the 'Coordinate System Data' archive from the 'Supplemental ArcGIS Runtime Data' tab. Unzip the archive to the 'SampleData' folder.",
+  "Instructions": "Tap on a listed transformation to re-project the point geometry (shown with a blue square) using the selected transformation. The reprojected geometry will be shown in red. If there are grid-based transformations for which projection engine files are not available locally, these will be shown in gray in the list. The default transformation is shown in bold. To download the additional transformation data, log on to your developers account (http://developers.arcgis.com), click the 'Download APIs' button on the dashboard page, and download the 'Coordinate System Data' archive from the 'Supplemental ArcGIS Runtime Data' tab. Unzip the archive to the 'SampleData' sub-folder of the ApplicationData directory, which can be found for each platform at run time with System.Environment.GetFolderPath(System.Environment.SpecialFolder.ApplicationData).",
   "Type": 0,
   "RequiresOnlineConnection": true,
   "RequiresOfflineData": false,

src/iOS/Xamarin.iOS/Samples/GeometryEngine/ListTransformations/metadata.json

@@ -2,7 +2,7 @@
   "Name": "List transformations by suitability",
   "SampleName": "ListTransformations",
   "Description": "This sample demonstrates how to use the TransformationCatalog to get a list of available DatumTransformations that can be used to project a Geometry between two different SpatialReferences, and how to use one of the transformations to perform the GeometryEngine.project operation. The TransformationCatalog is also used to set the location of files upon which grid-based transformations depend, and to find the default transformation used for the two SpatialReferences.",
-  "Instructions": "Tap on a listed transformation to reproject the point geometry (shown with a blue square) using the selected transformation. The reprojected geometry will be shown in red. If there are grid-based transformations for which projection engine files are not available locally, these will be shown in gray in the list. The default transformation is shown in bold. To download the additional transformation data, log on to your developers account (http://developers.arcgis.com), click the 'Download APIs' button on the dashboard page, and download the 'Coordinate System Data' archive from the 'Supplemental ArcGIS Runtime Data' tab. Unzip the archive to the 'SampleData' folder.",
+  "Instructions": "Tap on a listed transformation to re-project the point geometry (shown with a blue square) using the selected transformation. The reprojected geometry will be shown in red. If there are grid-based transformations for which projection engine files are not available locally, these will be shown in gray in the list. The default transformation is shown in bold. To download the additional transformation data, log on to your developers account (http://developers.arcgis.com), click the 'Download APIs' button on the dashboard page, and download the 'Coordinate System Data' archive from the 'Supplemental ArcGIS Runtime Data' tab. Unzip the archive to the 'SampleData' sub-folder of the ApplicationData directory, which can be found for each platform at run time with System.Environment.GetFolderPath(System.Environment.SpecialFolder.ApplicationData).",
   "Type": 0,
   "RequiresOnlineConnection": true,
   "RequiresOfflineData": false,