DOC/STY: formatting contributing page in docs

[jklenzing]

Description

Addresses #106

Fixes the formatting of the contributing doc for RTD. Updates some info on the contributing page based on the latest pysat develop branch.

Minor formatting updates for the ICON EUV docstring and example code.

Type of change

• Bug fix (non-breaking change which fixes an issue)

How Has This Been Tested?

Inspection of the build page at RTD:

https://pysatnasa.readthedocs.io/en/sty-rtd/develop_guide/contributing.html

Also at the github level: https://github.com/pysat/pysatNASA/blob/sty/rtd/CONTRIBUTING.md

Checklist:

• Make sure you are merging into the develop (not main) branch
• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published in downstream modules
• Add a note to CHANGELOG.md, summarizing the changes
• Update zenodo.json file for new code contributors

[jklenzing]

Style should be consistent, but I can't get rst to recognize the bullets. Documentation says that asterisks should be fine, but these aren't being built in sphinx.

EDIT: Needed to upgrade sphinx (>=4.3) to get the bullets to work for my local files.

[aburrell]

Also recommend adding ReadTheDocs to the CI checks. Would be especially useful for this PR.

[jklenzing]

Also recommend adding ReadTheDocs to the CI checks. Would be especially useful for this PR.

I see these are enabled in the pysat PRs, but don't see how to enable them in settings.

[aburrell]

I see these are enabled in the pysat PRs, but don't see how to enable them in settings.

I never remember how to do this, but I think it was as simple as adding a webhook in the settings.

[jklenzing]

I never remember how to do this, but I think it was as simple as adding a webhook in the settings.

All the projects have the same webhook, but only pysat is actually linking in the CI checks. Tried deleting and reconfiguring here.

[jklenzing]

All the projects have the same webhook, but only pysat is actually linking in the CI checks. Tried deleting and reconfiguring here.

Looks like it's a setting in readthedocs: "Build pull requests" under advanced settings. Reinstalling readthedocs since I broke the settings.