/publicgoods-candidates

Nominees and candidates for Digital Public Goods

Primary LanguageJavaScriptThe UnlicenseUnlicense

License: Unlicense Contributor Covenant CI

Nominees, Candidates and Digital Public Goods

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.

How to nominate a Digital Public Good

  1. Go to the nominees folder, and click on Create new file
  2. 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
  3. 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 any OPTIONAL fields. Delete any lines marked OPTIONAL that you don't want to include. For the license field, be sure to use an approved SPDX identifier.
  4. Scroll down and accept the suggested field for the commit message Create <filename>, and choose Create a new branch for this commit and start a pull request. Click on Propose new file
  5. 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
  6. 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.

Template

{
        "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",
                        "org_type": "REQUIRED - One of 'owner, 'maintainer', 'funder' or 'implementer',
                        "contact_name": "OPTIONAL - Name of contact individual in the organization",
                        "contact_email": "OPTIONAL - Email for contact individual in the organization"
                }
        ]
}

Specifying SDGs

In order to make it easy for downstream projects to process data from the SDGs field, data must comply to the following format (you must select one or more elements of the following array, where an element is defined by a number and string pair):

[
  [
    1,
    "No Poverty"
  ],
  [
    2,
    "Zero Hunger"
  ],
  [
    3,
    "Good Health and Well-Being"
  ],
  [
    4,
    "Quality Education"
  ],
  [
    5,
    "Gender Equality"
  ],
  [
    6,
    "Clean Water and Sanitation"
  ],
  [
    7,
    "Affordable and Clean Energy"
  ],
  [
    8,
    "Decent Work and Economic Growth"
  ],
  [
    9,
    "Industry, Innovation and Infrastructure"
  ],
  [
    10,
    "Reduced Inequalities"
  ],
  [
    11,
    "Sustainable Cities and Communities"
  ],
  [
    12,
    "Responsible Consumption and Production"
  ],
  [
    13,
    "Climate Action"
  ],
  [
    14,
    "Life Below Water"
  ],
  [
    15,
    "Life On Land"
  ],
  [
    16,
    "Peace, Justice and Strong Institutions"
  ],
  [
    17,
    "Partnerships for the Goals"
  ]
]

Specifying Sectors

Similarly to the SDGs field above, the data in the sectors must be from the predefined list below (you should select one or more elements of the following array, where an element is a string):

[
  "Advocacy",
  "Agriculture",
  "Anti-corruption",
  "Big Data",
  "Business Advocacy",
  "Capacity Development",
  "Centers of Excellence",
  "Civil society",
  "Climate",
  "Communication",
  "Conflict Resolution",
  "Consulting",
  "Corporate Partnerships",
  "Corporation and Business Management",
  "Data Collection",
  "Data Management & Policy",
  "Data Security",
  "Demobilization & Reintegration",
  "Democracy",
  "Development Impact",
  "Digital Development",
  "Digital/Data/Tech",
  "Disarmament",
  "Economics/Finance",
  "Education",
  "Emergency Response",
  "Employment",
  "Energy",
  "Engineering",
  "Enterprise Ecosystems",
  "Entertainment",
  "Environment",
  "Fair & Responsible Media",
  "Female Genital Mutilation",
  "Food",
  "Fragile States",
  "Gender and Minority Groups",
  "Governance",
  "Health",
  "Humanitarian",
  "Hunger",
  "Infrastructure",
  "Justice",
  "Livelihoods",
  "Logistics",
  "Management",
  "Media",
  "Membership Associations",
  "Midwifery",
  "Natural Resource Conflicts",
  "NGO",
  "Nutrition",
  "Peace",
  "Platform creation",
  "Religious Engagement",
  "Research",
  "Resource Management",
  "Security",
  "Stability",
  "Supply Chain Solutions",
  "Sustainability",
  "Sustainable Cities",
  "Training & Employment",
  "Transition",
  "Transparency & Accountability",
  "Travel and Hospitality",
  "Violent Extremism",
  "Water and Sanitation",
  "Workforce",
  "World Population",
  "Youth"
]

Requirements and Considerations

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.

License

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 hello@digitalpublicgoods.net 💌