search

italia / lg-acquisizione-e-riuso-software-per-pa-docs

Linee Guida su acquisizione e riuso di software per le pubbliche amministrazioni
Creative Commons Zero v1.0 Universal
13 stars 18 forks source link

Inserire le specifiche di API come esempio di documentazione tecnica. #49

Open ioggstream opened 5 years ago

ioggstream commented 5 years ago

Suggerimento

In queste righe

https://github.com/italia/lg-acquisizione-e-riuso-software-per-pa-docs/blame/c3d935b4d189b53afb3f782b4c67f10547e2204a/riuso-software/licenze-aperte-e-scelta-di-una-licenza.rst#L133

inserirei come esempio di documentazione tecnica le specifiche di API tramite IDL (wsdl, openapi, ...)

Motivazioni

Alcuni possono ritenere le specifiche scritte in formato machine-readable (eg con un Interface Definition Language) non parte della documentazione tecnica ma del software.