dtcenter / METdataio

https://metdataio.readthedocs.io/en/latest/index.html
Apache License 2.0
5 stars 3 forks source link

Modify Requirements section of the User's Guide #273

Closed jprestop closed 6 months ago

jprestop commented 7 months ago

Describe the Task

Modify the Requirements section of the User's Guide so that the information is not listed directly, but rather so that there is use of a literalinclude linking to the requirements.txt file, which will automatically stay updated.

@lisagoodrich, this repository differs slightly from METplotpy and METcalcpy. The text under Requirements about Python, currently states:

Python 3.10.4+ - Python 3.10.4 or higher must be installed. METdataio also requires the Python packages pymysql, pandas, numpy, pyyaml, and lxml. Please refer to the requirements.txt file for the version numbers.

Please create a subcategory of. "Requirements" called "Python Requirements" and then use the literal include like you did for METplotpy and METcalcpy. Please let me know if you have any questions.

As an example, refer to the METplus User's Guide. See this line in the PointStat.py which uses RST's .. literalinclude:: and renders on the web in what appears to be a code block in this section.

Time Estimate

<1 day of work

Sub-Issues

Consider breaking the task down into sub-issues.

Relevant Deadlines

METdataio-3.0.0 release

Funding Source

Split across accounts (@lisagoodrich let me know if you have any questions) 2702691 JNT DTC NSF BASE FUN… 2784543 NOAA R2O METp SW2 2799991 Met Office METplus S…

Assignee

Labels

Projects and Milestone

Define Related Issue(s)

Consider the impact to the other METplus components.

Task Checklist

See the METplus Workflow for details.