Merge pull request #433 from Esri/doc/408

docs: make it clearer that it takes two steps to create a feature service
Esri · Jan 15, 2019 · 88bf26b · 88bf26b
2 parents 2da07d3 + ca306cd
commit 88bf26b
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 7 deletions.
diff --git a/packages/arcgis-rest-feature-service-admin/src/addTo.ts b/packages/arcgis-rest-feature-service-admin/src/addTo.ts
@@ -1,4 +1,4 @@
-/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+/* Copyright (c) 2018-2019 Environmental Systems Research Institute, Inc.
  * Apache-2.0 */
 
 import { request, cleanUrl } from "@esri/arcgis-rest-request";
@@ -42,7 +42,7 @@ export interface IAddToServiceDefinitionResult {
  *   tables: []
  * });
  * ```
- * Add layer(s) and/or table(s) to a hosted feature service.
+ * Add layer(s) and/or table(s) to a hosted feature service. See the [REST Documentation](https://developers.arcgis.com/rest/services-reference/add-to-definition-feature-service-.htm) for more information.
  *
  * @param url - URL of feature service
  * @param requestOptions - Options for the request
@@ -54,8 +54,7 @@ export function addToServiceDefinition(
   requestOptions: IAddToServiceDefinitionRequestOptions
 ): Promise<IAddToServiceDefinitionResult> {
   const adminUrl =
-    cleanUrl(url).replace("/rest/services", "/rest/admin/services") +
-    "/addToDefinition";
+    `${cleanUrl(url).replace(`/rest/services`, `/rest/admin/services`)}/addToDefinition`;
 
   requestOptions.params = {
     addToDefinition: {},

diff --git a/packages/arcgis-rest-feature-service-admin/src/create.ts b/packages/arcgis-rest-feature-service-admin/src/create.ts
@@ -1,4 +1,4 @@
-/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+/* Copyright (c) 2018-2019 Environmental Systems Research Institute, Inc.
  * Apache-2.0 */
 
 import { request, getPortalUrl } from "@esri/arcgis-rest-request";
@@ -146,7 +146,10 @@ export interface ICreateServiceResult {
 
 /**
  * ```js
- * import { createFeatureService } from '@esri/arcgis-rest-feature-service-admin';
+ * import {
+ *   createFeatureService,
+ *   addToServiceDefinition
+ * } from '@esri/arcgis-rest-feature-service-admin';
  * //
  * createFeatureService({
  *   authentication: userSession,
@@ -156,7 +159,7 @@ export interface ICreateServiceResult {
  *   }
  * });
  * ```
- * Create a new hosted feature service.
+ * Create a new [hosted feature service](https://developers.arcgis.com/rest/users-groups-and-items/create-service.htm). After the service has been created, call [`addToServiceDefinition()`](../addToServiceDefinition/) if you'd like to update it's schema.
  * @param requestOptions - Options for the request
  * @returns A Promise that resolves with service details once the service has been created
  */