Merge pull request #226 from russelltrow/translation-template

Translation instructions and template

CONTRIBUTING.md

@@ -4,3 +4,39 @@
 2. Discuss Issue with Community Working Group (WG) --> Create Pull Request (PR) if required
 3. PR to be submitted against the **main** branch
 4. PR discussed with the WG. If agreed, the WG Chair will merge into **main** branch
+
+
+## Contributing a Translation
+
+We welcome community contributed translations of the course.
+
+### Prepare your translation
+
+To make the process simpler we have created a [locale template](https://github.com/Green-Software-Foundation/learn/tree/main/i18n/template) that you can duplicate and update.
+
+To prepare your translation follow these steps:
+
+1. Fork the repository: https://github.com/Green-Software-Foundation/learn/fork
+2. Create a new branch for your translation - e.g. "translation-de".
+3. Duplicate the template locale folder - "/i18n/template".
+4. Name the new folder based on the [language locale code](https://simplelocalize.io/data/locales/) - e.g. 'de' for German
+5. Update the course content in the "docusaurus-plugin-content-docs/current" folder.
+6. Optionally update the images in "docusaurus-plugin-content-docs/current/images". Contact us if you need access to the original image assets.
+7. Update the UI elements in "docusaurus-theme-classic/footer.json" & "docusaurus-theme-classic/navbar.json".
+
+### Test your translation
+
+```
+npm -g install yarn
+yarn install
+yarn run docusaurus start --locale <locale>
+```
+
+### Submit for review
+
+1. Raise a [Pull Request](https://github.com/Green-Software-Foundation/learn/pulls) for your translation against the **[main](https://github.com/Green-Software-Foundation/learn/tree/main)** branch.
+2. The PR will be reviewed by the the project team and feedback will be provided within 4 weeks.
+
+### Go Live
+
+Once approved the translation will be published on https://learn.greensoftware.foundation/

i18n/template/code.json

@@ -0,0 +1,2 @@
+{
+}

i18n/template/docusaurus-plugin-content-docs/current.json

@@ -0,0 +1,10 @@
+{
+ "version.label": {
+ "message": "Next",
+ "description": "The label for version current"
+ },
+ "sidebar.sidebar.category.Welcome": {
+ "message": "Welcome",
+ "description": "The label for category Welcome in sidebar sidebar"
+ }
+}

i18n/template/docusaurus-plugin-content-docs/current/carbon-efficiency.mdx

@@ -0,0 +1,158 @@
+---
+sidebar_position: 3
+title: Carbon Efficiency
+---
+
+import Quiz from "/src/components/Quiz";
+
+:::note
+This is a community contributed translation. It has limited support and might not match the latest English language version of the course.
+:::
+
+:::tip Principle
+
+_Emit the least amount of carbon possible._
+
+:::
+
+## Introduction
+
+Understanding the impact of greenhouse gases on our environment is key to understanding software's own carbon footprint. You will learn about the different kinds of greenhouse gases present in the environment, how they are emitted and measured, and what is being done by different organizations around the world to control and reduce these emissions.
+
+You will find out about the GHG protocol and what it means for green software practitioners.
+
+## Key concepts
+
+### Global warming vs climate change
+
+[Global warming](https://climate.nasa.gov/global-warming-vs-climate-change/) is the long-term heating of Earth's climate system observed since the pre-industrial period (between 1850 and 1900) due to human activities, primarily fossil fuel burning. [Climate change](https://climate.nasa.gov/global-warming-vs-climate-change/) is long-term shifts in temperatures and weather patterns. These shifts may be natural, but since the 1800s, human activities have been the main driver of climate change.
+
+### Climate vs weather
+
+Weather refers to the conditions of the atmosphere in a short period of time. Climate refers to the conditions of the atmosphere over long periods of time. Any changes to the long-term condition of the atmosphere will also cause changes to the short-term conditions. An obvious comparison is that if the average temperature of the atmosphere increases, the average temperature of the weather in any given season will also increase. Some examples of measurable changes to weather conditions due to climate change are:
+
+- Changes to the water cycle, including rainfall
+- Melting of ice
+- Heating of the land, air, and ocean
+- Changes in ocean currents, acidity, and salinity
+
+These changes can lead to flooding - both in coastal areas and due to increased rainfall - drought, wildfires and more frequent extreme weather conditions.
+
+### Greenhouse gases and the greenhouse effect
+
+Greenhouse gases are a group of gases that trap heat from solar radiation in the Earth's atmosphere. These gases act as a blanket, increasing the temperature on the surface of the Earth. This is a natural phenomenon which has been accelerated due to man-made carbon emissions. Now the global climate is changing at a faster rate than that at which animals and plants can adapt.
+
+Greenhouse gases and the greenhouse effect are crucial to all life on Earth and often come from natural sources like animals, volcanoes, and other geological activity. The greenhouse effect allows the Earth to maintain a higher temperature than it would without them by capturing more heat from solar radiation. Like many other natural processes of the Earth, the greenhouse effect is a finely tuned balance that can be upset by multiple factors.
+
+### Carbon and CO2eq
+
+Carbon is often used as a broad term to refer to the impact of all types of emissions and activities on global warming. CO2eq/CO2-eq/ CO2e, which stands for carbon equivalence, is a measurement term used to measure this impact. For example, 1 ton of methane has the same warming effect as about [84 tons of CO2 over 20 years](https://energy.ec.europa.eu/topics/oil-gas-and-coal/methane-emissions_en), so we normalize it to 84 tons CO2eq. We may shorten even further to just carbon, which is a term often used to refer to all GHGs.
+
+## Monitoring climate change
+
+As a result of the effects of climate change and an ever-increasing number of destructive weather events, efforts have been made by the global community to address these issues and take steps to control and limit global warming in order to mitigate and reverse the effects of climate change.
+
+The [**Paris Climate Agreement**](https://unfccc.int/process-and-meetings/the-paris-agreement/the-paris-agreement) is an international treaty agreed in 2015 by 196 parties and the UN to reduce the Earth's temperature increase. The agreement is to keep the rise in global mean temperature to 2°C compared to pre-industrial levels, with a preferable lower limit of 1.5°C. The agreement is reviewed every five years and mobilizes finance to developing nations to mitigate the impacts of climate change and prepare for and adapt to the environmental effects caused by climate change. In addition, each party is expected to update its progress through a Nationally Determined Contribution (NDC). The agreement is currently signed by 193 parties.
+
+The [**United Nations Framework Convention on Climate Change (UNFCCC)**](https://unfccc.int/process-and-meetings/the-convention/what-is-the-united-nations-framework-convention-on-climate-change) is a group created to achieve the stabilization of greenhouse gas concentrations in the atmosphere at a level that would prevent dangerous interference with the climate system.
+
+The [**COP (Conference of the Parties)**](https://unfccc.int/process/bodies/supreme-bodies/conference-of-the-parties-cop) is an annual event involving all parties in the United Nations Framework Convention on Climate Change. At the conference, each party member's progress on tackling global warming, as agreed as part of the Paris Climate Agreement, is reviewed and assessed. The COP is also a chance for parties to come together and make decisions that will reduce the effects of global warming. Common topics include strategies to reduce carbon, financing low carbon strategies and preservation of natural habitats.
+
+The [**IPCC (Intergovernmental Panel on Climate Change)**](https://www.ipcc.ch/about/), created by the UN in 1988, aims to provide governments at all levels with scientific information that they can use to develop climate policies. IPCC reports are also a key input into international climate change negotiations. The IPCC is an organization of governments that are members of the United Nations or the World Meteorological Organization (WMO). The IPCC currently has 195 members.
+
+We will always emit carbon through our activities but being carbon efficient means minimizing the amount of carbon emitted per unit of work. We aim to ensure that for each gram of carbon we emit into the atmosphere, we extract the most value possible.
+
+![alt_text](./images/02_monitoring_climate_change.png "image_tooltip")
+
+In the software space, the part we play in the climate solution is **building carbon-efficient applications**. Being carbon efficient is about building applications that add the same value for you or your users but which emit less carbon.
+
+## Summary
+
+- Greenhouse gases are a group of gases contributing to global warming. Carbon is often used as a broad term to refer to the impact of all types of emissions and activities on global warming. CO2eq is a measurement term used to measure this impact.
+- The international community, in groups such as the UNFCCC, has come together to limit the impact of global warming by reducing emissions, aiming for a 'preferable' lower limit of 1.5°C. This was agreed through the UN IPCC in 2015 in the [Paris Climate Agreement](https://unfccc.int/process-and-meetings/the-paris-agreement/the-paris-agreement) and is monitored at the regular COP event.
+- Everything we do emits carbon into the atmosphere, and our goal is to emit the least amount of carbon possible. This constitutes the first principle of green software: carbon efficiency, emitting the least amount of carbon possible per unit of work.
+
+## Quiz
+
+<Quiz
+ QuizList={[
+ {
+ question: "What are GHGs?",
+ answers: [
+ { text: "Greenhouse gases", isCorrect: true },
+ { text: "Global Heating gases", isCorrect: false },
+ { text: "Government Health Gateway", isCorrect: false },
+ ],
+ },
+ {
+ question: "How can we abbreviate carbon equivalent?",
+ answers: [
+ { text: "CO2eq or CO2e", isCorrect: false },
+ { text: "carbon or CO2e", isCorrect: false },
+ { text: "CO2eq or carbon", isCorrect: false },
+ { text: "CO2eq or CO2e or carbon", isCorrect: true },
+ ],
+ },
+ {
+ question: "What is the IPCC?",
+ answers: [
+ { text: "International Panel on Climate Change", isCorrect: false },
+ { text: "Intergovernmental Panel on Climate Change", isCorrect: true },
+ { text: "International Proposal on Climate Change", isCorrect: false },
+ ],
+ },
+ {
+ question: "What is COP?",
+ answers: [
+ { text: "Carbon Offsetting Project", isCorrect: false },
+ { text: "Conference on Pollution", isCorrect: false },
+ { text: "Conference of the Parties", isCorrect: true },
+ ],
+ },
+ {
+ question:
+ "What was the agreed preferred limit to the temperature rise in the Paris Climate Agreement?",
+ answers: [
+ { text: "1.5ºC", isCorrect: true },
+ { text: "2ºC", isCorrect: false },
+ { text: "2.5ºC", isCorrect: false },
+ ],
+ },
+ {
+ question: "Which of the following statements is true?",
+ answers: [
+ {
+ text: "Short term changes in the weather indicate long term changes to the climate",
+ isCorrect: false,
+ },
+ {
+ text: "Long term climate changes affect short-term weather conditions",
+ isCorrect: true,
+ },
+ ],
+ },
+ {
+ question:
+ "What has been the key driver of climate change in recent years?",
+ answers: [
+ { text: "Naturally occurring changes", isCorrect: false },
+ { text: "Human activity", isCorrect: true },
+ { text: "A combination of the above", isCorrect: false },
+ ],
+ },
+ {
+ question: "What do we need greenhouse gases for?",
+ answers: [
+ {
+ text: "Capturing more heat from the Sun to sustain life on Earth",
+ isCorrect: true,
+ },
+ {
+ text: "Reflecting heat away from the Earth",
+ isCorrect: false,
+ },
+ { text: "Nothing, they’re always damaging", isCorrect: false },
+ ],
+ },
+ ]}
+/>