Welcome! 👋 We are glad that have found this repo and you are interested in Digital Public Goods, and using technology to make this world a more just and equitable one. We are in this together: the more the greater impact!
This repository is used to manage the process of adding nominees for consideration as Digital Global Public Goods. This is one of four interconnected repositories; refer to the publicgoods-website for an overview.
- Go to the nominees folder, and click on
Create new file
- Name the new file with the name of the digital public good in kebab-case, and
.json
as the extension. For example: wikipedia.json or inlcusion-ukr.json - Use the template from the section below to include the requested information. Be sure to include the fields marked
REQUIRED
with the corresponding information, as well as anyOPTIONAL
fields. Delete any lines markedOPTIONAL
that you don't want to include. For thelicense
field, be sure to use an approved SPDX identifier. - Scroll down and accept the suggested field for the commit message
Create <filename>
, and chooseCreate a new branch for this commit and start a pull request
. Click onPropose new file
- You are taken to a new page where you can leave a comment about the file you are about to propose to add, and finally click on
Create Pull Request
- Wait for the green checkmark to say
All checks have passed
to have confirmation that the file complies with the expected format, and is ready to merge pending a review.
{
"name": "REQUIRED",
"aliases": "[OPTIONAL: Array of strings - Abbreviations, initialisms, or alternate names, where relevant",
"description": "REQUIRED",
"license": [REQUIRED, Array of objects:
{
"spdx": "SDPX identifier for this license",
"licenseURL": "Link to the license under which this nominee is released"
}
],
"website": "REQUIRED",
"SDGs": [REQUIRED, Array of objects listing SDGs by number and name],
"type": [REQUIRED, Array of strings, multiple choice from "software", "data", "standards"],
"repositoryURL": "OPTIONAL: Link to main repository",
"sectors:" [OPTIONAL: Array of strings - List of sectors that this nominee addresses.]
"organizations": [REQUIRED, Array of objects:
{
"name": "REQUIRED - Name of the organization",
"website": "OPTIONAL - Website of the organization",
"contact_name": "OPTIONAL - Name of contact individual in the organization",
"contact_email": "OPTIONAL - Email for contact individual in the organization",
"org_type": "REQUIRED - One of 'owner, 'maintainer', 'funder' or 'implementer'
}
]
}
For those projects that match the initial set of requirements, anyone can open a Pull Request on this repository as a submission following these guidelines:
- Data for each nominee is stored as a JSON file. JSON (JavaScript Object Notation) is a lightweight data-interchange format. It is easy for humans to read and write. It is easy for machines to parse and generate.
- Each nominee json file is kept under the
nominees/
folder, add yours there. Use any other of the existing nominees as a reference for what fields to include, and how to enter the required information. - Each nominee json file is validated using the JSON-schema found at the root of this repository: nominee-schema.json. Each submission needs to pass the automated validation (
continuous-integration/travis-ci
) before being merged into the existing repository. - The
license
field is standardized using SPDX identifiers.
From the set of nominee json files, this list of Digital Global Public Goods is automatically generated and kept in sync with the contents of this repo.
This is free and unencumbered software released into the public domain.
Anyone is free to copy, modify, publish, use, compile, sell, or
distribute this software, either in source code form or as a compiled
binary, for any purpose, commercial or non-commercial, and by any
means.
All the information compiled and aggregated in this repository is already in the public domain, thus we dedicate this software to the public domain. As a result, we impose no limitations nor requirements of any kind of how you use it or reuse it. As a courtesy on your part, we would very much appreciate hearing from you either on how you are using the information in this repo, or any great ideas on how we can collaborate together. Email us at [email protected] 💌