What is publiccode.yml?

The publiccode.yml standard is a simple way for government agencies to describe the software they build, so that other agencies can actually find and reuse it. The idea is that lots of public administrations create useful software tools, but hardly anyone else knows these tools exist or whether they'd work in a different city or country. The project defines a standard file, literally called publiccode.yml, that sits inside a software project and describes it in a consistent way. The file includes things like the project title and description, who built it, what stage of development it's in, who handles maintenance, and what legal or technical requirements it has. The format is meant to be readable by both humans and computers, so a civil servant could open it and understand what the software does, while a search tool could scan it automatically. This would be useful for government IT staff, policy teams, or anyone working in public administration who wants to avoid building a solution from scratch. If one city builds an app for reporting potholes and documents it with this standard, another city could find it and evaluate whether the same approach would work for them. The file captures details that matter for government contexts specifically, like which national legal frameworks the software supports, that you wouldn't find in a typical open-source project's README. The project is still in early development (alpha status) at version 0.1, and was created by the Italian Digital Transformation Team. There's also a related effort to build a scanner that crawls public websites looking for these files and publishes what it finds as open data, making the whole ecosystem more discoverable.