From 863b834a9ac71b0c38cb988f11bd5fb3c4591487 Mon Sep 17 00:00:00 2001 From: Fabio Bonelli Date: Wed, 26 Aug 2026 10:58:15 +0200 Subject: [PATCH] doc: explain what indexers do with the format --- docs/standard/index.rst | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/docs/standard/index.rst b/docs/standard/index.rst index 61b754a..f2f74ca 100644 --- a/docs/standard/index.rst +++ b/docs/standard/index.rst @@ -7,8 +7,15 @@ discoverable and thus reusable by other entities. By including a ``publiccode.yml`` file in the root of a repository, and populating it with information about the software, technicians and civil -servants can evaluate it. Automatic indexing tools can also be built, since the -format is easily readable by both humans and machines. +servants can evaluate it. + +The format is easily readable by both humans and machines, and +automatic indexing tools are built on top of it: national software +catalogs crawl the published files and build searchable sites. +Catalogs federate across countries, since they all read the same +format. The `core tools +`__ +provide the reference implementations to build on. ``publiccode.yml`` is mandatory for all public software developed in Italy, according to the national `guidelines