Merge branch 'master' into NA/doc_user_feedback

Author: nanaeaubry

guide/02-api-overview/release_notes_241.ipynb

@@ -1,5 +1,63 @@
 {
  "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "c1ea9231-7b0b-4e36-aed7-77c1b7a894c7",
+   "metadata": {},
+   "source": [
+    "# What's new in version 2.4.1.1"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "5f206e81-771b-4684-a769-f5738d08936d",
+   "metadata": {},
+   "source": [
+    "#### [`arcgis.gis`](/python/latest/api-reference/arcgis.gis.toc.html)\n",
+    "* [`ContentManager`](/python/latest/api-reference/arcgis.gis.toc.html#arcgis.gis.ContentManager)\n",
+    "  * [`clone_items()`](/python/latest/api-reference/arcgis.gis.toc.html#arcgis.gis.ContentManager.clone_items)\n",
+    "    * Fixes incorrect output when cloning *text* based items\n",
+    "    * Fixes errors when cloning content with *WKT* spatial references\n",
+    "    * Fixes `_ItemCreateException` when cloning feature layers with editor tracking enabled\n",
+    "    * **BUG-000174140** Fixes failures when cloning *Form* items created in Survey123 Connect with editor tracking enabled\n",
+    "    * **BUG-000175735** Fixes issues where *folder* and *search_existing_items* arguments were not read correctly with *StoryMap* themes\n",
+    "    * **BUG-000174859** Fixes issue when cloning previously cloned ArcGIS Enterprise items to another ArcGIS Enterprise deployment\n",
+    "    * Fixes issue when cloning *Form* items to ArcGIS on Kubernetes deployments\n",
+    "#### [`arcgis.gis.admin`](python/latest/api-reference/arcgis.gis.admin.html)\n",
+    "* [`Kubernetes`](/python/latest/api-reference/arcgis.gis.admin.html#kubernetes)\n",
+    "  * [`KubeServiceDirectory`](python/latest/api-reference/arcgis.gis.admin.html#kubeservicedirectory)\n",
+    "    * Fixes `AttributeError` with *folders* property preventing correct return values \n",
+    "#### [`arcgis.features`](/python/latest/api-reference/arcgis.features.toc.html)\n",
+    "* [`FeatureLayer`](/python/latest/api-reference/arcgis.features.toc.html#arcgis.features.FeatureLayer)\n",
+    "  * [`query()`](/python/latest/api-reference/arcgis.features.toc.html#arcgis.features.FeatureLayer.query)\n",
+    "    * Fixes infinite looping and incorrect results when using *result_record_count* argument\n",
+    "#### [`arcgis.apps`](/python/latest/api-reference/arcgis.apps.html)\n",
+    "* [`arcgis.apps.itemgraph`](/python/latest/api-reference/arcgis.apps.itemgraph.html)\n",
+    "  * [`create_dependency_graph()`](/python/latest/api-reference/arcgis.apps.itemgraph.html#create-dependency-graph)\n",
+    "    * Updates error handling for corrupted content and accommodates larger number of items\n",
+    "    * Updates internal processing to accommodate items which were incorrectly not written to output\n",
+    "    * Fixes incorrect inclusion of items outside an organization for various graphs\n",
+    "  * [`import_list()`](/python/latest/api-reference/arcgis.apps.itemgraph.html#import-list)\n",
+    "    * Fixes error when importing *views* based on previously published feature layers \n",
+    "* [`arcgis.apps.survey123`](/python/latest/api-reference/arcgis.apps.survey123.html)\n",
+    "  * [`Survey`](/python/latest/api-reference/arcgis.apps.survey123.html#arcgis.apps.survey123.Survey)\n",
+    "    * [`publish()`](/python/latest/api-reference/arcgis.apps.survey123.html#arcgis.apps.survey123.Survey.publish)\n",
+    "      * Fixes `InvalidDefinition` error caused by incorrect definitions for *EditorTrackinInfo* \n",
+    "#### [`arcgis.learn`](/python/api-reference/arcgis.learn.toc.html)\n",
+    "* Removed the *SatlasPretrain* models from list of supported backbones for classification and detection models\n",
+    "* [Data Preparation Methods](/python/latest/api-reference/arcgis.learn.toc.html#data-preparation-methods)\n",
+    "   * [`prepare_data()`](/python/latest/api-reference/arcgis.learn.toc.html#arcgis.learn.prepare_data)\n",
+    "     * Remove warnings regarding status for various *torchvision* namespaces\n",
+    "* [Inferencing Methods](/python/latest/api-reference/arcgis.learn.toc.html#inferencing-methods)\n",
+    "   * [`classify_objects()`](/python/latest/api-reference/arcgis.learn.toc.html#classify-objects)\n",
+    "     * Fixes error where *threshold* is ignored when using *input_features* argument\n",
+    "   * [`classify_pixels()`](/python/latest/api-reference/arcgis.learn.toc.html#classify-pixels)\n",
+    "     * Fixes tool failure because of inability to load *HEDEdgeDetector* model\n",
+    "* [Model Management](/python/latest/api-reference/arcgis.learn.toc.html#model-management)\n",
+    "   * [`train_model()`](/python/latest/api-reference/arcgis.learn.toc.html#arcgis.learn.train_model)\n",
+    "     * Fixes errors and failures to generate output finding learning rate and showing results in Linux environments"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "38657f92",
@@ -700,7 +758,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.11"
+   "version": "3.13.2"
   },
   "toc": {
    "base_numbering": 1,

guide/03-the-gis/accessing-and-creating-content.ipynb

@@ -1427,9 +1427,9 @@
     "\n",
     "To create new items on your GIS, use the [`add()`](https://developers.arcgis.com/python/latest/api-reference/arcgis.gis.toc.html#arcgis.gis._impl._content_manager.Folder.add) method on a [`Folder`](/python/api-reference/arcgis.gis.toc.html#folder) instance. You can get an individual _folder_ using the [`Folders.get()`](/python/api-reference/arcgis.gis.toc.html#arcgis.gis._impl._content_manager.Folders.get) method.\n",
     "\n",
-    "The `add()` method accepts a dictionary containing the properties of the item to be created. The optional `file`, `text`, `url`, and `data_url` parameters accept input to add the actual content. \n",
+    "The `add()` method accepts a dictionary or [`ItemProperties`](https://developers.arcgis.com/python/latest/api-reference/arcgis.gis.toc.html#itemproperties) object containing the properties of the item to be created. The optional `file`, `text`, `url`, and `data_url` parameters accept input to add the actual content. \n",
     "\n",
-    "All content you add this way is added to the authenticated user's folders. Let us connect to our Enterprise instance, add a csv file as an item and then publish a feature layer from it.\n",
+    "All content you add this way is added to the authenticated user's folder. Let us connect to our Enterprise instance, add a csv file as an item and then publish a feature layer from it.\n",
     "\n",
     "For example, set up a path to the data:\n",
     "`data_path = os.path.join(r\"<your_drive>:\\\\\", \"path\", \"to\", \"data\")`"
@@ -1494,7 +1494,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "The `add()` method returns an object of type `arcgis.gis.Item` representing the added item. In Jupyter notebook environment, you can visualize it by querying the item"
+    "The calling `result()` on the `add()` method returns an object of type `arcgis.gis.Item` representing the added item. In Jupyter notebook environment, you can visualize it by querying the item"
    ]
   },
   {
@@ -1539,7 +1539,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "**Note**: You can specify most properties of an item as a dictionary to the `item_properties` parameter. Refer to the [API ref doc](https://developers.arcgis.com/python/api-reference/arcgis.gis.toc.html#arcgis.gis.ContentManager.add) of this method for a definitive list. You could also specify an empty dictionary to this parameter, the downside is search cannot index these items efficiently if it does not have sufficient metadata information, hence that is not a good programming practice."
+    "**Note**: You can specify most properties of an item as a dictionary or [`ItemProperties`](https://developers.arcgis.com/python/latest/api-reference/arcgis.gis.toc.html#itemproperties) object to the `item_properties` parameter. Refer to the [API ref doc](https://developers.arcgis.com/python/api-reference/arcgis.gis.toc.html#arcgis.gis.ContentManager.add) of this method for a definitive list. You could also specify an empty dictionary to this parameter, the downside is search cannot index these items efficiently if it does not have sufficient metadata information, hence that is not a good programming practice."
    ]
   },
   {

update_items.py

@@ -182,7 +182,7 @@ def _stage_and_upload_item(self, entry, share_after_upload=True):
             log.info(f"    Uploaded succeeded -> {item.homepage}")
         except Exception as e:
             self.failed_uploads.append(entry['title'])
-            log.warn(f"    Couldn't upload {entry['title']}: {e}")
+            log.warning(f"    Couldn't upload {entry['title']}: {e}")
             log.debug(traceback.format_exc())
 
     def _infer_item_id(self, url):