A metadata description standard for public software and policy repositories that is easy to use both for developers and less technical people in order to make the software developed by public administrations and public organisations easily discoverable.
- Schema
- Italian extension to the schema
- List of acceptable tags
- How to work with forks and variants
- Example
This alpha is developed by the Italian Digital Transformation Team and the Authors.
Many great software projects are developed by public administrations, however reuse of these projects is very limited. Some of the reasons for low uptake of these projects is a lack of discoverability and that it is hard to find out what project can actually work in the context of a different public administration.
The publiccode.yml
file is meant to solve these problems. It is an easily readable file for civil servants that are trying to figure out whether a project will work for them, and easily readable for computers. It contains information such as:
- The title and description of the project or product in English and/or other languages
- The status of development, e.g. 'concept', 'alpha', 'beta', 'released', 'deprecated'
- By what organisation this project is developed
- Who is caring for the maintenance and when this runs out
- Who to contact for technical or support inquiries
- What national and local legal frameworks this project or product works in
- What proprietary software dependencies this project or product has
The format should both be able to easily be added to any new project, as well as grow with the project as it grows beyond the original context it was developed in.
You can find all publiccode.yml
on GitHub files by searching using the frontend or the API.
Feel free to submit Pull Requests and to file Issues.
The website at https://yml.publiccode.net/ is automatically generated from the master
branch of the publiccode.yml
repository using GitHub pages and its static site generator Jekyll and the Foundation For Public Code jekyll theme.
Licenced under the CC-0