SP-1635: page for per-account user compute resources

[MelissaGraham]

Add new page summarizing RSP user resources (storage, compute, etc.).

[jonathansick]

First, could you name the PR? I'd recommend: SP-1635: Document account resources. This makes it easier for the RSP team.

Second, could you consider rebasing and squashing many of the commits: https://docs.github.com./en/get-started/using-git/using-git-rebase-on-the-command-line I've noticed a lot of repeated "Update ..." type commits in the Git history and they've made it harder to keep up to date with rsp_lsst_io.

Recommendations for this page:

I'd recommend shortening the URL a bit: docs/guide/resources.

Another thing to consider is separating what resources are given to a user from the overall platform capacity. Right now both are stated in the same sections. The information actionable to a user is their own quotas, and I think that information should come first. The platform capacity and estimates of how many users can be on the platform before it degrades can be a later reference section because it's not action-able information to our users.

Lastly, I notice a lot of intended footnotes in this page. Here's the syntax for creating footnotes in reStructuredText: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#footnotes The native syntax links between the footnote marker and the footnote, so it's useful.

[MelissaGraham]

Thanks @jonathansick. Agree on all suggestions and incorporated them all in one commit.

• changed PR title to "SP-1635: page for per-account user compute resources"
• rebased to main
• yes I can squash-and-merge the PR when the time comes
• renamed folder as /guides/resources
• moved "Number of users" sub-section down to the bottom

I'd kind of wanted the "footnotes" to be within each subsection but I switched to using the RST format for bottom-of-the-page footnotes.

[MelissaGraham]

Not merging and not requesting review because this page is not finished, still awaiting inputs and final quantity estimates.

[womullan]

ok for me - TBDs need SQuaRE and USDF to comment