@arcgis/core 4.29.0-next.20231102 → 4.29.0-next.20231104

package/README.md

@@ -6,15 +6,17 @@ A minified, unbuilt version of the [ArcGIS Maps SDK for JavaScript](https://deve
 
 For an overview of the SDK, visit the [developer documentation](https://developers.arcgis.com/javascript/latest/key-features/) site.
 
-You can install these modules with [npm](https://npmjs.org/) and then use them directly in a framework such as [React](https://reactjs.org/), [Vue.js](https://vuejs.org) or [Angular](https://cli.angular.io/). Or, you can also create your own custom builds with [Webpack](https://webpackjs.org) or [Rollup](https://rollupjs.org).
+You can install this package with [npm](https://npmjs.org/) and then use it directly in a framework such as [React](https://reactjs.org/), [Vue.js](https://vuejs.org) or [Angular](https://cli.angular.io/). Or, you can also create your own custom builds with a module bundler such as [Webpack](https://webpackjs.org) or [Rollup](https://rollupjs.org).
 
 The SDK includes [TypeScript](https://www.typescriptlang.org/) type definitions. The `.d.ts` declaration files are bundled with the install.
 
-Sample applications can be found at [github.com/Esri/jsapi-resources/](https://github.com/Esri/jsapi-resources/tree/master/esm-samples).
+For more information on using the `next` versions, visit the [feedback-js-api-next](https://github.com/Esri/feedback-js-api-next/blob/main/README.md) repository.
+
+Sample applications can be found at [github.com/Esri/jsapi-resources/](https://github.com/Esri/jsapi-resources/tree/main/esm-samples).
 
 ## Get started
 
-Install the modules into your project:
+Install the package into your project:
 
 ```
 npm install @arcgis/core
@@ -22,35 +24,25 @@ npm install @arcgis/core
 
 ## Configure CSS
 
-Set the CSS to the same version as the installed SDK modules. You can verify the installed SDK version by running `npm list @arcgis/core`. If you are working with locally hosted assets skip to the _Manage assets locally_ section.
+Set the CSS to the same version as the installed package. You can verify the installed SDK version by running `npm list @arcgis/core`. If you are working with locally hosted assets skip to the _Manage assets locally_ section.
 
-The first example shows importing CSS for production SDK version `4.26.0`:
+The first example shows importing CSS for the `latest` SDK version: `4.28.7`:
 
 _index.css_
 
 ```css
-@import "https://js.arcgis.com/4.26/@arcgis/core/assets/esri/themes/light/main.css";
+@import "https://js.arcgis.com/4.28/@arcgis/core/assets/esri/themes/light/main.css";
 ```
 
-The second example shows importing CSS for `next` SDK version `4.27.0-next.20230519`:
-
-_index.css_
-
-```css
-@import "https://cdn.jsdelivr.net/npm/@arcgis/core@4.27.0-next.20230519/assets/esri/themes/light/main.css";
-```
-
-For more information on using the next version, visit the [feedback-js-api-next](https://github.com/Esri/feedback-js-api-next/blob/main/README.md) repository.
-
 ## Working with assets
 
-The default configuration for local builds is for the SDK to automatically pull assets from a CDN at runtime, there is no need for additional configuration. The assets include styles, images, web workers, wasm and localization files. Production and `rc` versions of the SDK's assets are hosted on the ArcGIS CDN, while `next` builds (e.g. `4.27.0-next.20230519`) use assets hosted on the jsDelivr CDN.
+The default configuration for local builds is for the SDK to automatically pull assets from a CDN at runtime. There is no need for additional configuration. The assets include styles, images, web workers, wasm and localization files. `latest` and `rc` versions of the SDK's assets are hosted on the ArcGIS CDN, while `next` versions use assets hosted on the jsDelivr CDN.
 
 ### Manage assets locally
 
-If you need to manage the assets locally, copy them into your project from `/node_modules/@arcgis/core/assets`, and then set `config.assetsPath` to ensure requests for assets are resolved correctly. A simple way to accomplish this is to configure a npm script that runs during your build process. For example, use npm to install `ncp` and configure a script in package.json to copy the folder.
+If you need to manage the assets locally, copy them into your project from `/node_modules/@arcgis/core/assets`, and then set `config.assetsPath` to ensure requests for assets are resolved correctly. A simple way to accomplish this is to configure an npm script that runs during your build process. For example, use `cp` on MacOS and Windows PowerShell, or [`xcopy`](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/xcopy) on Windows, and configure a script in the package.json to copy the folder.
 
-**Important:** Every time you upgrade the SDK, be sure to recopy the new version of the assets to your project. This ensures the assets stay synchronized.
+**Important:** Every time you upgrade the SDK, be sure to recopy the new version of the assets into your project. This ensures the assets and API library stay synchronized.
 
 Here’s a React example:
 
@@ -59,8 +51,8 @@ _package.json_
 ```json
 {
   "scripts": {
-    "start": "ncp ./node_modules/@arcgis/core/assets ./public/assets && react-scripts start",
-    "build": "ncp ./node_modules/@arcgis/core/assets ./public/assets && react-scripts build"
+    "start": "cp -R ./node_modules/@arcgis/core/assets ./public/assets && react-scripts start",
+    "build": "cp -R ./node_modules/@arcgis/core/assets ./public/assets && react-scripts build"
   }
 }
 ```
@@ -78,7 +70,7 @@ _index.css_
 @import "@arcgis/core/assets/esri/themes/light/main.css";
 ```
 
-For Angular, copy the asset files by configuring the `architect/build/options/assets` section of `angular.json`, for example:
+For Angular,  one example is to copy the asset files by configuring the `architect/build/options/assets` section of `angular.json`, for example:
 
 _angular.json_
 
@@ -121,15 +113,13 @@ _package.json_
 }
 ```
 
-Windows users can use [`xcopy`](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/xcopy) or [`ncp`](https://www.npmjs.com/package/ncp) for any platform.
-
 ## Requirements
 
 Use of the ArcGIS Maps SDK for JavaScript is subject to [System Requirements](https://developers.arcgis.com/javascript/latest/system-requirements/), and the terms described in the product-specific [Terms of Use.](https://www.esri.com/en-us/legal/terms/product-specific-scope-of-use) Learn more about licensing [here](https://developers.arcgis.com/javascript/latest/licensing/).
 
 ## Resources
 
-- [ArcGIS Maps SDK for JavaScript](https://developers.arcgis.com/javascript/)
+- [ArcGIS Maps SDK for JavaScript - Build with ES modules](https://developers.arcgis.com/javascript/latest/es-modules/)
 - [http://blogs.esri.com/esri/arcgis/tag/javascript/](https://blogs.esri.com/esri/arcgis/tag/javascript/)
 - [twitter@EsriDevs](https://twitter.com/EsriDevs)