diff --git a/docs/index.mdx b/docs/index.mdx index 6e595b3..173c1e6 100644 --- a/docs/index.mdx +++ b/docs/index.mdx @@ -18,46 +18,77 @@ import Image from "@theme/IdealImage"; - Develop a series of baseline specifications for Green Software. - Ensure that the specifications can be implemented in an interoperable fashion on the computing platforms in widespread use in both developed and developing regions. +### Get Involved + +- How to join: Please contact help@greensoftware.org +- Pre-read: [Link](https://github.com/Green-Software-Foundation/software_carbon_intensity) + ### How we work -- We hold weekly meetings on Thursdays @1630 (BST) you can [see the minutes of every meeting on our repo on GitHub](https://github.com/Green-Software-Foundation/standards_wg/tree/main/Agenda_Minutes). -- To make a proposal for a change in one of our standards, start a thread on the discussions page in the Github repository of the standard. +- We hold weekly meetings on Thursdays @1630 (BST) you can view [our minutes here](https://github.com/Green-Software-Foundation/standards-wg/issues?q=is%3Aopen+is%3Aissue+label%3AAgenda%2FMinutes). +- To make a proposal for a change in one of our standards, start a thread on the [discussions page](https://github.com/Green-Software-Foundation/standards-wg/discussions/landing). - Once the thread has gained some momentum with comments, ideas, and inputs from the rest of the group, convert it to an issue through the option on the right-hand side menu. - Once the issue has sufficient material and agreement from the group on it, create a pull request linking that issue. -- Pull requests are reviews by the group and if there is consensus merged during our weekly calls. +- Pull requests are reviewed by the group and if there is consensus merged during our weekly calls. ### Projects - [Software Carbon Intensity (SCI) Specification](https://greensoftware.foundation/projects/software-carbon-intensity-sci-specification) -- [SCI Reporting](https://greensoftware.foundation/projects/sci-reporting) +- [SCI Guide](https://github.com/Green-Software-Foundation/sci-guide) +- [Software Carbon Efficiency Rating](https://github.com/Green-Software-Foundation/scer) +- [Real-Time Cloud](https://github.com/Green-Software-Foundation/real-time-cloud) +- [Organisation Usage of Software Emission](https://github.com/Green-Software-Foundation/organisation-usage-of-software-emissions) + +### Proposing a new project + +- To propose a project, we ask that you create a short project document and gather the interest of at least three people from 2 different member organizations. +- Reach out to the chairs, who will add you to the next working group meeting agenda. +- If the working group reaches consensus and agrees, your project will be made official and start receiving the support of the Foundation. +- However, often it requires several conversations with the working group to evolve your project proposal to a version where everyone is comfortable. +- Once launched, the working group will support you in executing your project and source the resources required from the Foundation and its members. ### Links -- [Press Release FAQ](https://github.com/Green-Software-Foundation/pr-faqs/blob/main/live/green-software-principles.pr-faq.md) - [Main Website](https://standards.greensoftware.foundation/) - [Main GitHub Repository](https://github.com/Green-Software-Foundation/standards_wg) - [Slack](https://greensoftwarefdn.slack.com/archives/C027QDQSA8M) (Private for GSF Members Only) - [Google Drive Folder](https://drive.google.com/drive/folders/1YKwvDw4PMI7LAd7mhdqQ2Xwa7RW8iUHk?usp=sharing)(Private for GSF Members Only) -- [Our Handbook](https://docs.google.com/document/d/1Cra_NRdwHgQktiVbo4UgULz4Xjd1OxRjbBtkETUes2s/edit?usp=sharing)(Private for GSF Members Only) +- [Our Handbook](https://greensoftwarefoundation.atlassian.net/wiki/spaces/~612dd45e45cd76006a84071a/pages/819277/Standards+Working+Group) ### Communications - For members: Our main form of communication is email via standards_wg@greensoftware.foundation. -- For non-members: The best method of communication is to open a GitHub issue in **this** repository. +- For non-members: The best method of communication is to open a GitHub issue [here](https://github.com/Green-Software-Foundation/standards-wg/issues) repository. ### Chairs - + linkedin="abhishekguptamcgill"> Abhishek Gupta - + + Henry Richardson + + + Navveen Balani + + + + Sean Mcilroy + + + +If anything here is wrong, please email help@greensoftware.foundation diff --git a/docs/onboarding_guide.md b/docs/onboarding_guide.md new file mode 100644 index 0000000..4d8b789 --- /dev/null +++ b/docs/onboarding_guide.md @@ -0,0 +1,21 @@ +--- +sidebar_position: 2 +--- + +# Onboarding + +Thank you for your interesting in participating in the Standards Working Group! We're excited to have you contribute to this project. + +To get the most out of the working group we've created a few resources to get you up to speed: + +## Read the Specification +The specification forms the foundation of everything that this working group focuses on. We suggest that you read the SCI specification cover to cover (don't worry, it's not that long!). Not only will you be intimately familiar with this key document, but your fresh eyes will help identify gaps and limitations in the current specification. If there are areas that you have questions about and want to dig deeper, we suggest looking at the FAQ (forthcoming). If questions remain or there are ambiguities, this may be a perfect area that you can help us improve the specification. The most recent version of the specificaiton can be found here (it might be wise to view the 'dev' branch to see the current draft version as well). + +## Onboarding Session +Once a month the working group asks all new members to briefly introduce themselves and explain their interest in the Standards Working group at the beginning of the regularly scheduled working group call. This is a great time to raise any questions about the specification or indicate areas of expertise that you can contribute to. + +## Mentor for New Members +We assign a 'buddy' to new members who can answer questions, orient you to key topics, and generally support getting you up to speed so that you can meaningfully contribute to the working group. You and the mentor should work out the most effective way for you to communicate, whether by call, email, or other messaging platform. + +## Operations +The 'How We Work' section explains how we work by consensus, when we meet, what projects we are working on, and some other details of how to contribute. diff --git a/docs/onboarding_guide.mdx b/docs/onboarding_guide.mdx deleted file mode 100644 index ce647e6..0000000 --- a/docs/onboarding_guide.mdx +++ /dev/null @@ -1,17 +0,0 @@ ---- -sidebar_position: 2 ---- - -import TeamMember, { TeamMembers } from "@site/src/components/TeamMember"; -import Image from "@theme/IdealImage"; - -# Onboarding (In Draft) - - -
-
- -## Onboarding - diff --git a/docs/sci-data.md b/docs/sci-data.md new file mode 100644 index 0000000..2cec6ff --- /dev/null +++ b/docs/sci-data.md @@ -0,0 +1,6 @@ +--- +sidebar_position: 3 +--- + +# [SCI-Data](https://github.com/Green-Software-Foundation/sci-data/blob/web/docs/GettingStarted.md) + diff --git a/docusaurus.config.js b/docusaurus.config.js index 8dec910..ed1eb92 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -37,9 +37,6 @@ const config = { theme: { customCss: require.resolve("./src/css/custom.css"), }, - gtag: { - trackingID: "G-593HJXNS18", - }, sitemap: { changefreq: "weekly", priority: 0.5,