Define our 'value add' in our documentation

[Sophietn]

Why use the CA SDK and not the electricity maps/watttime APIs directly?

This Q came up in the last Opensource Working Group call, and I (who's close to the project) don't even feel clear on the answer.
Making this glaringly obvious in our docs and sharing in gsf-wide newsletter might help us gain new adopters.

Notes from a quick chat with @danuw on this topic

1. Coverage

The SDK allows for quicker changing between data sources eg. WattTime and ElectricityMaps, than developing and maintaining a separate integration for each API data provider.
The SDK also allows you to add your own data sources.

2. Standardised access

Get started quicker - no need to be own broker of the APIs.
We handle the upgrades, so users only need to change credentials / endpoints?

3. Benefit from other users past experiences of the data source APIs. De-duplicate efforts.

[Sophietn]

Discussion on 21st May
We found it in our docs - https://carbon-aware-sdk.greensoftware.foundation/docs/overview
What does the SDK/API provide that 3rd party data providers such as WattTime or ElectricityMaps do not?
But we agreed this could be punchier, and we could surface this on the website front page update the website front page where the 4 pictures of dinosaurs are.

[Sophietn]

Discussion on 28th May
to do:

• Update the front page of our documentation

[github-actions]

This issue has not had any activity in 120 days. Please review this issue and ensure it is still relevant. If no more activity is detected on this issue for the next 20 days, it will be closed automatically.