From 4430b401dea2e384339b799b0a6068d5a722f7fb Mon Sep 17 00:00:00 2001 From: Shelby Switzer Date: Mon, 24 May 2021 10:14:39 -0400 Subject: [PATCH] As an open source community member, I want to know what Justice40-specific terms and acronyms mean. (#75) * Add glossary from open source kickoff * Updates to glossary * Add EVCM because we use this in user stories in this repo's sprint backlog (which is visible / recorded in the form of Github Issuess) * Update Climate and Environment Justice Screening Tool to Climate and Economic Justice Screening Tool, as per the original Executive Order Co-authored-by: Shelby Switzer --- README.md | 4 ++++ docs/glossary.md | 27 +++++++++++++++++++++++++++ 2 files changed, 31 insertions(+) create mode 100644 docs/glossary.md diff --git a/README.md b/README.md index 1ba0e8bb..9b4c8521 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,10 @@ Contributions are always welcome! See `CONTRIBUTING.md` for ways to get started. +## Glossary + +Confused about a term? Heard an acronym and have no idea what it stands for? Check out [our glossary](docs/glossary.md)! + ## Feedback If you have any feedback or questions, please reach out to us at justice40open@usds.gov. diff --git a/docs/glossary.md b/docs/glossary.md new file mode 100644 index 00000000..eecc1bd4 --- /dev/null +++ b/docs/glossary.md @@ -0,0 +1,27 @@ +# Glossary + +This glossary is intended to be a helpful guide to terms and acronyms we use across the Justice40 project and in our open source community. We'll try to keep this list update to date and in alphabetical order for ease of use. If you see an error, please help leave this repo better than you found it by submitting a pull request with the fix :) + +If you don't see the term you're looking for here, please submit an issue to this repo with the term in question and why you think it should be added. + +Know a term and its definition that you don't see here? Make a pull request with the term, definition, and reason for inclusion and a team member will review shortly. + +*Pro tip: Use CMD+F on Mac or Ctrl+F on Windows to search the page.* + +| Term | Definition | +| ---- | ---------- | +| CEJST | Climate and Economic Justice Screening Tool. This is the tool we are building to support the Justice40 initiative and help identify historically overburdened and underserved communities for benefits. | +| Contributor | Someone who participates in the open source community by contributing code, documentation, information, discussion, etc. | +| Data Roadmap | Our way to keep track of what data has been suggested and prioritized for inclusion in the CEJST and manage prioritization and eventual integration into the tool. | +| EVCM | Experience-validating community member. This is a user profile that we use when conceiving user stories, and represents members of the community who may view or use the tool and give feedback on whether the tool or the data it uses accurately reflects their experience. | +| Github | An online tool for publishing, sharing, and discussing code. | +| Google Group | A listserv / mailing list product from Google that lets you subscribe to updates and partipcipate in discussions. Our open source data+tech Google Group is available here: https://groups.google.com/u/4/g/justice40-open-source | +| Indicator | An environmental indicator is a numerical value that helps provide insight into the state of the environment or human health. Indicators are developed based on quantitative measurements or statistics of environmental condition that are tracked over time. | +| Issue | A Github issue is a way to report a bug, request a feature, or start a discussion on a topic in a Github code repository. | +| Maintainer | A project maintainer is someone who has special responsibilities and privileges in an open source project, such as an admin or owner. Right now, for us, this means folks on the USDS Justice40 team. | +| MVP | Minimum Viable Product | +| Pull Request | Way to submit code or documentation for review on Github before it is integrated into the source code. | +| Repository | A repository on Github is the place where source code for a system or app is published, and it has collaborative features such as issues, project boards, and pull requests. | +| WHEJAC | White House Environment Justice Advisory Council. This is a diverse group of 25-30 Environment Justice advocates, experts, and community representatives who drive the product vision for the Climate and Economic Justice Screening Tool. | +| YAML | Format for writing text in both a human-readable and machine-readable way. This lets us automate with files easily while still being able to interact with the text easily as people. | +| Zenhub | Project management tool that integrates with Github. This is what we use to manage our sprint backlog and is available here: https://app.zenhub.com/workspaces/justice40-60993f6e05473d0010ec44e3/board?repos=358242767 |