-
Notifications
You must be signed in to change notification settings - Fork 41
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1087 from Green-Software-Foundation/docs
Add enablement.md file
- Loading branch information
Showing
2 changed files
with
116 additions
and
7 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,115 @@ | ||
# Enablement Guide for Impact Framework (IF) | ||
|
||
## What is the Impact Framework? | ||
|
||
The **Impact Framework (IF)** empowers you to calculate and understand the environmental impact of your software. It comes with a standard library of built-in plugins, referred to as builtins, and an Explorer for discovering and installing third-party plugins. | ||
|
||
## How to Use the Impact Framework? | ||
|
||
### Prerequisites | ||
|
||
Before getting started, ensure you have the following: | ||
|
||
1. **Node.js**: Installed and configured. | ||
2. **NPM**: Comes with Node.js; ensure it’s updated. | ||
3. **Access to Documentation**: Familiarize yourself with the [IF documentation](https://if.greensoftware.foundation/). | ||
4. **Basic YAML Knowledge**: For creating and managing manifest files. | ||
|
||
## Steps to Enable the Impact Framework | ||
|
||
### Step 1: Installation | ||
|
||
Install the latest version of IF globally using NPM: | ||
|
||
```sh | ||
npm install -g "@grnsft/if" | ||
``` | ||
|
||
`IF` provides multiple command-line tools, with the primary tool being `if-run`. | ||
|
||
### Step 2: Working with Command-Line Tools | ||
|
||
1. `if-run`: Execute Manifest Files | ||
|
||
- Description: Executes manifest files to calculate impact. | ||
- Manifest File: A YAML file central to IF functionality. It contains configurations, application architecture, input data, and serves as a portable, shareable, human-readable document for audits. | ||
- Usage: | ||
|
||
```sh | ||
if-run --manifest <path-to-your-manifest-file> | ||
``` | ||
|
||
More about if-run [here](https://if.greensoftware.foundation/reference/cli#if-run). | ||
|
||
2. `if-env`: Create Local Development Environments | ||
|
||
- Description: Sets up a local environment for running manifests. | ||
- Usage: | ||
|
||
```sh | ||
mkdir my-manifest && cd my-manifest | ||
if-env | ||
``` | ||
|
||
Find details in the [documentation](https://if.greensoftware.foundation/reference/cli#if-env). | ||
|
||
3. `if-check`: Verify Manifests | ||
|
||
- Description: Combines the functionalities of if-env and if-diff to verify manifest files with outputs and execution sections. | ||
- Usage: | ||
|
||
```sh | ||
# Check a specific manifest file | ||
if-check -m <path-to-your-manifest-file> | ||
|
||
# Check all manifests in a directory | ||
if-check -d /path-to-your-manifests | ||
``` | ||
|
||
Explore more in the [documentation](https://if.greensoftware.foundation/reference/cli#if-check). | ||
|
||
4. `if-csv`: Save Data to CSV | ||
|
||
- Description: Saves calculated impact data to a CSV file. | ||
- Usage: | ||
|
||
```sh | ||
if-csv -m ./my-manifest.yml -p carbon | ||
``` | ||
|
||
Read more in the [documentation](https://if.greensoftware.foundation/reference/cli#if-csv). | ||
|
||
5. `if-diff`: Compare Manifests or Outputs | ||
|
||
- Description: Compares two manifest or output files to identify differences. | ||
- Usage: | ||
|
||
```sh | ||
if-diff <file1> <file2> | ||
``` | ||
|
||
Details are available in the [documentation](https://if.greensoftware.foundation/reference/cli#if-diff). | ||
|
||
### Step 3: Explore Plugins | ||
|
||
- Built-In Plugins: Utilize IF’s built-ins for common environmental impact assessments. | ||
- Third-Party Plugins: Visit the Explorer to discover and install third-party plugins tailored to your needs. | ||
|
||
### Step 4: Help and Guidance | ||
|
||
For assistance with any command, use the --help flag: | ||
|
||
```sh | ||
if-run --help | ||
``` | ||
|
||
## Additional Resources | ||
|
||
- Documentation: [IF Documentation](https://if.greensoftware.foundation) | ||
- Third-Party Plugins: [Plugin Explorer](https://explorer.if.greensoftware.foundation) | ||
|
||
## Support | ||
|
||
Join the IF Community for updates and discussions: | ||
|
||
- Mailing List: [[email protected]](https://groups.google.com/u/1/a/greensoftware.foundation/g/if-community) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -3,7 +3,7 @@ | |
[![Node.js CI](https://github.com/Green-Software-Foundation/if/actions/workflows/nodejs-ci.yml/badge.svg)](https://github.com/Green-Software-Foundation/if/actions/workflows/nodejs-ci.yml) | ||
|
||
> [!IMPORTANT] | ||
> Graduated Project This project is a Graduated Project, supported by the Green Software Foundation. The publicly available version documented in the README is trusted by the GSF. New versions of the project may be released, or it may move to the Maintained or Retired Stage at any moment. | ||
> Incubation Project: This project is an incubation project being run inside the Green Software Foundation; as such, we DON’T recommend using it in any critical use case. Incubation projects are experimental, offer no support guarantee, have minimal governance and process, and may be retired at any moment. This project may one day Graduate, in which case this disclaimer will be removed. | ||
**Our documentation is online at [if.greensoftware.foundation](https://if.greensoftware.foundation/)** | ||
|
||
|
@@ -64,12 +64,6 @@ if-run -h | |
|
||
Please read our documentation at [if.greensoftware.foundation](https://if.greensoftware.foundation/) | ||
|
||
## Video walk-through | ||
|
||
Watch this video to learn how to create and run a `manifest`. | ||
|
||
[![Watch the walk-through video](https://i3.ytimg.com/vi/R-6eDM8AsvY/maxresdefault.jpg)](https://youtu.be/GW37Qd4AQbU) | ||
|
||
## Join our mailing list | ||
|
||
We have a public mailing list at [[email protected]](https://groups.google.com/u/1/a/greensoftware.foundation/g/if-community). We send out weekly updates that explain what we've shipped, what we're working on and how you can get involved each week! | ||
|