Merge updated docs

[RuaridhMacd]

Description

Merging updated documentation into main.

Type of change

Please delete options that are not relevant.

• Documentation update

Related Issues

None

Checklist:

• 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 (e.g., docstrings for new functions, updated/new .md files in the docs folder)
• My changes generate no new warnings
• I have tested the code to ensure it works as expected
• New and existing unit tests pass locally with my changes:

julia> using Pkg
julia> Pkg.test("MacroEnergy")

• I consent to the use of the MacroEnergy.jl license for my contributions.

How to test the code

Reference to an example case or a test case that can be run to verify the changes.

Additional context

Add any other context about the PR here. If you have any questions, please contact the maintainers.

[RuaridhMacd]

Hi @lbonaldo, I added you as a reviewer just to make sure you're ok with these updates being merged and that they won't overwrite anything else you've added to main directly.