JCSDA / spack-stack

Creative Commons Zero v1.0 Universal
27 stars 46 forks source link

Document python environment and methodology #1302

Closed srherbener closed 2 days ago

srherbener commented 1 month ago

Is your feature request related to a problem? Please describe. Python package management is difficult to do in a consistent manner across many platforms. There exist many ways to tackle this problem and if a wide variety of approaches are utilized this becomes unmanageable in regard to support and maintenance.

There exist two areas of concern

spack-stack development has been moving toward a relatively simple and consistent method for setting up and using the spack python environment and the application python environment. At this point we need to document and help foster adoption of these method.

Describe the solution you'd like Documentation exists that explains the management of python for both spack-stack development, and applications (built upon spack-stack) environments.

Additional context None

climbfuji commented 1 month ago

@christinaholtNOAA FYI

christinaholtNOAA commented 1 month ago

Documentation in this area would be a huge value add.

srherbener commented 1 month ago

Any thoughts about where this documentation should live: spack-stack ReadTheDocs, spack-stack Wiki? I'm leaning toward the Wiki, but I'm okay if ReadTheDocs (or some other place) is preferred. tagging @climbfuji, @AlexanderRichert-NOAA.

Thanks!

climbfuji commented 1 month ago

I'd say readthedocs