italia / docs-italia-guide

Guida alla pubblicazione dei documenti su Docs Italia
https://docs.italia.it/italia/docs-italia/docs-italia-guide/it/bozza/index.html
Creative Commons Attribution 4.0 International
5 stars 23 forks source link

Policy per la definizione dei nomi dei publisher #32

Open pdavide opened 5 years ago

pdavide commented 5 years ago

Da una breve chiacchierata con @danielaiozzo è emerso che sarebbe opportuno pubblicare sulla guida una policy per la definizione dei nomi dei publisher (e quindi delle organizzazioni GitHub) perché questi impattano molto sulla leggibilità degli URL. Questo, da un lato, eviterebbe casi estremi come "ufficioCircolariComuneDiAmbaradan" oppure "sono-un-fan-di-docs-italia", e dall'altro garantirebbe una più facile identificazione dei publisher a partire dagli URL (sia per gli utenti che per i motori di ricerca). Sarebbe auspicabile avere degli schemi per:

Questa policy, ovviamente, non avrebbe carattere prescrittivo e varrebbe solo per le amministrazioni che non hanno ancora un'organizzazione GitHub.

cc @francescozaia @atorin @sbronzolo

alterat commented 5 years ago

Mi sembra un'ottima idea!

Operativamente, il nome del publisher che appare nell'URL al momento è il nickname dell'organizzazione su GitHub, giusto? Se invece usassimo il valore short-name nel publisher_settings.yml, potremmo chiedere all'organizzazione di modificarlo secondo le nostre linee guida, senza dover richiedere di creare una nuova organizzazione solo per cambiare il nome.

pdavide commented 5 years ago

In realtà non so se usiamo già lo short-name oppure no. @paoloromolini @yakky?