Skip to content

Commit

Permalink
Merge pull request #485 from Green-Software-Foundation/docs/update-ov…
Browse files Browse the repository at this point in the history
…erview-and-graducation-disclaimer

Docs overview, disclaimer & pipeline updates for graduation
  • Loading branch information
vaughanknight committed Mar 6, 2024
2 parents 52705a6 + fe6797d commit 734605d
Show file tree
Hide file tree
Showing 28 changed files with 353 additions and 441 deletions.
2 changes: 2 additions & 0 deletions .github/workflows/6-jekyll-gh-pages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,8 @@ jobs:
run: |
# Moving the samples folder at build& deploy time of the docs so that it appears in the end result
cp -r ./samples/ ./casdk-docs/docs/
cp -r ./README.md ./casdk-docs/docs/overview/overview.md
cp -r ./CONTRIBUTING.md ./casdk-docs/docs/overview/contributing.md
working-directory: .

- name: Install dependencies
Expand Down
4 changes: 2 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ We have opportunities for both code and non code contributors. We're currently l
|**Sample Creation** | These help adopters of the SDK learn how they can quick get started and build their own carbon aware solutions.|
|**Documentation Updates** | The documentation always can be improved to make the Carbon Aware SDK more accessible to everyone. Guides, SDK and API document, and more! |
|**Video Content Creation (how to enable, demos etc)** | Quick videos help adopters undersatnd just how easy it is to get started in an easy to consume form.
|**Slide Deck Creation <br> Available for presenter use, including real time video demo**| We get a lot of traction at conferences, and if we have a standard deck for anyone to present, it will enable those who might not be able to create a deck, but could easily present it, to also participate.
|**Slide Deck Creation <br /> Available for presenter use, including real time video demo**| We get a lot of traction at conferences, and if we have a standard deck for anyone to present, it will enable those who might not be able to create a deck, but could easily present it, to also participate.

## How To Get Started
Introduce yourself on on our [discussions page](https://github.com/orgs/Green-Software-Foundation/discussions/65) and let us know where you think you can help.
Expand Down Expand Up @@ -85,7 +85,7 @@ do **not** open an issue to request features.
3. PR to be submitted against the **DEV feature branch**
4. PR discussed with the WG. If agreed, the WG Chair will merge into **DEV
Feature branch**
![GSF Single-Trunk Based Branch Flow](/docs/images/single-trunk-branch.svg)
![GSF Single-Trunk Based Branch Flow](./images/readme/single-trunk-branch.svg)
5. See
[The Way we Work](https://github.com/Green-Software-Foundation/standards_wg/blob/main/the_way_we_work.md)
for futher details.
32 changes: 8 additions & 24 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,13 @@
<div id="header" align="center">
<img style=”margin: 0px” src=./images/hack-banner.png alt=”banner” height=”500" />
</div>

----------------------------

**Welcome to [CarbonHack 24](https://grnsft.org/hack/github) from the Green Software Foundation.**

> From Monday, 18th March - Monday, 8th April 2024, participants will compete to showcase their best application of IF in measuring the environmental impacts of software.
>
> Carbon Hack is a dynamic competition that combines healthy rivalry with collaborative innovation. Hackers will push the limits of the framework, uncover potential weaknesses, and create innovations to enhance the tool.
>
> CarbonHack is open to all, including software practitioners and those with a passion for Green Software.
>
> Find out more about CarbonHack 2024 on the [CarbonHack website](https://grnsft.org/hack/github). Check out the [FAQ on GitHub](https://grnsft.org/hack/faq).
>
> Registration opens 15th January!
----------------------------

---
sidebar_position: 2
---

# Carbon Aware SDK
Carbon aware software does more when it can leverage greener energy sources, and less when the energy CO2 emissions are higher.

The Carbon Aware SDK is a toolset to help you measure the carbon emissions of your software, in turn helping you **measure and reduce your software's carbon emissions**, and choose when and where you run your software to make it greener.

![Carbon Aware Software](./images/carbon-aware-software.png)
![Carbon Aware Software](./images/readme/carbon-aware-software.png)


By knowing the carbon emissions of the energy that powers your applications, you and your organisation can leverage greener energy sources to reduce your CO2 emissions by:
Expand All @@ -44,7 +28,7 @@ Head on over to the [Getting Started Overview Guide](./casdk-docs/docs/overview/
Get started on creating sustainable software innovation for a greener future
today!

![Green Software](./images/what-is-green-software.avif)
![Green Software](./images/readme/what-is-green-software.avif)

# How Does This Work?
You can reduce the carbon footprint of your application by just running things
Expand All @@ -56,7 +40,7 @@ When software does more when the electricity is clean and do less when the
electricity is dirty, or runs in a location where the energy is cleaner, we call
this **carbon aware software**.

![Carbon Aware Software](./images/types-of-green-software.png)
![Carbon Aware Software](./images/readme/types-of-green-software.png)

The Carbon Aware SDK helps you build the carbon aware software solutions with
the intelligence to use the greenest energy sources. Run them at the greenest
Expand Down Expand Up @@ -84,7 +68,7 @@ management and increase control and auditability, especially in regulated
environments. It can be deployed as a container for easy management, and can be
deployed alongside an application within a cluster or separately.

![WebApi Screenshot](./casdk-docs/docs/images/screenshot_web_api.png)
![WebApi Screenshot](./images/readme/screenshot_web_api.png)

### The CLI

Expand All @@ -93,7 +77,7 @@ where a command-line can be used. This tends to be common with legacy DevOps
pipelines to drive deployment for integration testing where you can test your
deployment in the greenest location.

![WebApi Screenshot](./casdk-docs/docs/images/screenshot_cli.png)
![WebApi Screenshot](./images/readme/screenshot_cli.png)

## Who Is Using the Carbon Aware SDK?

Expand Down
2 changes: 2 additions & 0 deletions casdk-docs/.gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -18,3 +18,5 @@
npm-debug.log*
yarn-debug.log*
yarn-error.log*

docs/overview/README.md
2 changes: 1 addition & 1 deletion casdk-docs/docs/overview/adopters.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 6
sidebar_position: 7
---

# Carbon Aware SDK adopters
Expand Down
91 changes: 91 additions & 0 deletions casdk-docs/docs/overview/contributing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
# GSF Member Contribution Guide

Welcome to the GSF Carbon Aware SDK, and thank you for your interest in contributing to this
project. This guide outlines the steps for working within the Carbon Aware SDK
and the approved contribution process that members should follow.

#### _Before contributing, please read the [GSF Opensource Working Group charter](https://github.com/Green-Software-Foundation/charter/blob/main/charter.md). Any contributions must comply with the charter._ ####

## Table of Contents

- [GSF Member Contribution Guide](#gsf-member-contribution-guide)
- [Table of Contents](#table-of-contents)
- [Current Opportunities](#current-opportunities)
- [How To Get Started](#how-to-get-started)
- [Code Contribution Steps](#code-contribution-steps)
- [Public Issues](#public-issues)
- [Collaborating with the OSWG](#collaborating-with-the-opensource-working-group)

## Current Opportunities
We have opportunities for both code and non code contributors. We're currently looking all contributions, with some areas of extra opportunity outlined in the table below.


| Contribution Areas | Description |
|----------|----------|
|**Sample Creation** | These help adopters of the SDK learn how they can quick get started and build their own carbon aware solutions.|
|**Documentation Updates** | The documentation always can be improved to make the Carbon Aware SDK more accessible to everyone. Guides, SDK and API document, and more! |
|**Video Content Creation (how to enable, demos etc)** | Quick videos help adopters undersatnd just how easy it is to get started in an easy to consume form.
|**Slide Deck Creation <br /> Available for presenter use, including real time video demo**| We get a lot of traction at conferences, and if we have a standard deck for anyone to present, it will enable those who might not be able to create a deck, but could easily present it, to also participate.

## How To Get Started
Introduce yourself on on our [discussions page](https://github.com/orgs/Green-Software-Foundation/discussions/65) and let us know where you think you can help.
Find the Project Key contacts in the [Confluence page](https://greensoftwarefoundation.atlassian.net/wiki/spaces/~612dd45e45cd76006a84071a/pages/17137665/Opensource+Carbon+Aware+SDK).

If you are a GSF member organisation employee, you should:
Fill out the [Onboarding form](https://greensoftware.foundation/onboarding/) if you are new to the GSF; or
Fill out the [Subscribe form](https://greensoftware.foundation/subscribe/) if you are already part of the GSF but want to join this project.
Following this, you'll receive an invite to join the Carbon Aware SDK Weekly Meeting.
Only members of the foundation can join meetings and internal conversations.

If you are NOT a GSF member organisation employee, individual contributions are still welcome on our public Github repo eg. raising PRs, joining discussions.

Only our Project Leads have the right to merge PRs.

Any questions, email [email protected].

## Code Contribution Steps

For the following code contribution:

"Member and "Contributor" refer to the GSF member looking to make a feature
code contribution. "Chair" refers to the Chair, Co-Chair or other accountable
authority within GSF.

1. Submit a Public Issue using the Issue Template
2. The Issue will be looked at by a Chair and approved.
3. The Contributor is assigned an "Approved Reviewer" who will help shepherd the
feature into the GSF Repository
4. Fork `GSF/carbon-aware-sdk/dev` into a member repository,
`member/carbon-aware-sdk/dev`
5. Open a Draft PR from `member/dev` into `GSF/carbon-aware-sdk/dev` using the
PR Template
6. Once development is over, the Approved Reviewer pushes the PR into the "Ready
for Review" state
7. If the Chair accepts the PR, it merges into `GSF/carbon-aware-sdk/dev`

### Project Release Schedule:
At most once per month.
As frequent as possible.
We prioritise Security release over Feature release. Documentation release is not restricted.

## Public Issues

All contributions to the GSF are tracked through public issues. Please make a
public issue and fill out details on the proposed feature contribution. The
issue serves as a commitment by the contributor to developing the feature.

The Issue is **not** a feature request, but tracks expected feature work. Please
do **not** open an issue to request features.

## Collaborating With The [Opensource Working Group](https://github.com/Green-Software-Foundation/opensource-wg)

1. Create a
[new Issue](https://github.com/Green-Software-Foundation/standards_wg/issues/new)
2. Discuss Issue with WG --> Create PR if required
3. PR to be submitted against the **DEV feature branch**
4. PR discussed with the WG. If agreed, the WG Chair will merge into **DEV
Feature branch**
![GSF Single-Trunk Based Branch Flow](./images/readme/single-trunk-branch.svg)
5. See
[The Way we Work](https://github.com/Green-Software-Foundation/standards_wg/blob/main/the_way_we_work.md)
for futher details.
4 changes: 2 additions & 2 deletions casdk-docs/docs/overview/enablement.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 2
sidebar_position: 3
---

# Enablement
Expand Down Expand Up @@ -56,7 +56,7 @@ You can build a container containing the [WebAPI](../src/CarbonAware.WebApi)
You can reference the [Carbon Aware C# Library](../src/GSF.CarbonAware) in your
projects and make use of its functionalities and features.

| ![Image 2](../images/screenshot_cli.png) | ![Image 1](../images/screenshot_web_api.png) |
| ![Image 2](./images/readme/screenshot_cli.png) | ![Image 1](./images/readme/screenshot_web_api.png) |
|:---:|:---:|
| CLI | WebAPI |

Expand Down
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes.
Loading

0 comments on commit 734605d

Please sign in to comment.