How to contribute samples and guide chapters

First off, thank you for writing for the ArcGIS API for Python. Below are some guidelines to follow when writing your notebooks. These will help maintain the quality of content and help our CICD system integrate your articles and publish them on the https://developers.arcgis.com/python website in a semi-automated process.

Coding standards for your notebooks

Checkout this article https://www.esri.com/about/newsroom/wp-content/uploads/2018/11/coding-standards-jupyter-ntbk.pdf for some guidelines on how to structure your notebooks and make them more reader friendly

Accessing the GIS data

The Python API team maintains an ArcGIS Enterprise running at https://pythonapi.playground.esri.com/portal/home/. You can access this Enterprise GIS from your notebooks using the credentials username: arcgis_python and password: amazing_arcgis_123. Any outputs, maps, layers etc. created by this account would be periodically erased.

To publish the layers required for your notebooks, use a different account: username: api_data_owner, password: email the maintainers of this repo. Once you publish the layers, delete protect it and share it for all in the organization. Share the original data (for features, zip up the shape file or file geodatabase, for rasters, zip up the geoTIFF or imagery files) and upload it as an item inside the original_data folder.

Thus the data usage pattern is to first publish your content using api_data_owner manually and then access it in the notebooks using the account arcgis_python. Esri holds ownership of the data you publish.

Embedding maps in your notebook

See How to embed map images in your notebook wiki for details. Submit your PRs with the maps embedded

Submission checklist

• Ensure your notebook has a title, introduction and a conclusion
• Ensure your notebook file name has all lower characters, spaces replaced with dashes, no apostrophe or special characters
• Spell check your notebook
• Follow the coding guidelines article to structure your content
• Publish and access all your data to pythonapi playground portal
• Embed your map images
• Ensure your notebook runs in a reliable fashion