Really poor documentation

Question

Hello Esri Developer Team,

I am currently struggling to integrate the ArcGIS Maps SDK for JavaScript with the React framework.

At present, there are two main ways to integrate AMSDK with React: one uses @ArcGIS/core, and the other utilizes the so-called map-components. However, there is no documentation available on how to make them work together using @ArcGIS/core.

I was also shocked to discover that I had to open Storybook to understand how to use web components. Additionally, the sample in the startup section (https://developers.arcgis.com/javascript/latest/get-started-react/) fails to include npm install @ArcGIS/map-components, which contradicts the examples in your GitHub repository.

Lastly, I must express my frustration with your KPI product. It does not meet enterprise-level standards and is, frankly, a joke.

shiyanlim · Answer

Thanks for your reply! I love @ArcGIS/core and use it as a fallback solution when map components don’t work as expected. In React, I can always rely on useState to provide the MapView instance as soon as I set the container, rather than waiting for the onArcGISViewReady event from map components  to trigger a callback

AndyGup · Answer

@shiyanlim  thanks for the feedback and sorry about the frustration. Many doc improvements are coming in the 4.32 release, which is tentatively scheduled for later this month. For example, both the components and core API references will be integrated as you expect them to be. There's updated tutorials and more.