enable eamxx docs + add pyscream docs

[mahf708]

Enables building eamxx docs on E3SM repo; adds pyscream prelim docs as well.
Add content to eamxx user and dev guide main pages.

[github-actions]

PR Preview Action v1.4.8
🚀 Deployed preview to https://E3SM-Project.github.io/E3SM/pr-preview/pr-6748/
on branch gh-pages at 2024-11-14 23:34 UTC

[bartgol]

Maybe the eamxx-gh-pages action should be updated to actually be the E3SM mkdocs action? Meaning, change the name, and check paths for ALL yml/md files and folders that can impact gh-pages for the whole project?

[mahf708]

Maybe the eamxx-gh-pages action should be updated to actually be the E3SM mkdocs action? Meaning, change the name, and check paths for ALL yml/md files and folders that can impact gh-pages for the whole project?

The e3sm-gh-pages action already does it all; note the shiny new EAMxx section here: https://docs.e3sm.org/E3SM/pr-preview/pr-6748/EAMxx/

We will remove the eamxx-gh-page action once we freeze the scream repo

[bartgol]

Ah, I quickly glanced at the folder and missed the e3sm-gh-pages file. Well, then follow up: why do we need two actions in this repo? Can't we just rm the eamxx one right now?

[mahf708]

Ah, I quickly glanced at the folder and missed the e3sm-gh-pages file. Well, then follow up: why do we need two actions in this repo? Can't we just rm the eamxx one right now?

We run the eamxx one in scream repo. The scream docs (docs.e3sm.org/scream) have all been generated from the eamxx-gh-pages action. The E3SM docs (docs.e3sm.org/e3sm) have all been generated from the e3sm-gh-pages action. We had two because we started the scream one before and it was "unsupported" so it was easier to just keep it separate

I updated the eamxx-gh-pages one here in case we do e3sm->scream sync between now and the freeze

[mahf708]

@rljacob could we please integrate this? We need it for the newsletter release. I assigned you as FYI, so please feel free to reassign someone else, thanks :)

[mahf708]

Thanks, @rljacob for the edits and the merge 💌