Ciclo di vita di una guida #2 - Proposte di modifica

Discussioni relative alla Gestione del wiki Guide@Debianizzati.Org

Ciclo di vita di una guida #2 - Proposte di modifica

Messaggioda HAL 9000 » 21/12/2019, 10:53

A distanza di tempo dai task di Revisione Wiki #55 (e i collegati: #56, #57 e #58) sul ciclo di vita di una guida, e a seguito della prima revisione delle guide da quando è in vigore il nuovo sistema di categorie nascoste sulle guide da controllare, penso siano emerse delle criticità da correggere e siano possibili anche alcuni miglioramenti.

Gli obiettivi sono:
  1. permettere il controllo di categoria mancante dalle guide (impossibile se una guida appartiene a una categoria nascosta);
  2. facilitare la fase di revisione delle guide, riducendo il numero di stati di una guida e gli interventi manuali non essenziali;
  3. ridurre il più possibile la necessità di interventi su guide che non saranno revisionate, soltanto per spostarle da un template/categoria a un altro;
  4. facilitare la verifica per la stable in via di rilascio; e migliore gestione delle release volatili durante l'anno di rilascio, tenendo conto dei maggiori cambiamenti cui vanno incontro;
  5. rendere il template "Versioni compatibili" il più possibile completo, così da non necessitare di altre informazioni o messaggi di avviso per segnalare lo stato della guida che si legge; anche a distanza di tempo dalla stesura della guida;
  6. far sì che la ricerca del Wiki restituisca, per quanto possibile con le risorse disponibili, le sole guide più aggiornate; lasciando che le guide che necessitano di interventi (e non solo di un controllo) siano tracciabili da template e relative categorie.
  7. documentare il tutto, in modo che sia facilmente comprensibile e in futuro eventualmente anche modificabile.
E le proposte per raggiungerli sono le seguenti:
  1. rimozione di tutte le categorie nascoste di compatibilità (eccetto che "compatibili per tutte le versioni"), lasciando solo quelle per la non compatibilità, in modo da permettere il controllo di assenza di categorie dalle guide valide; le altre sono comunque da revisionare;
  2. riduzione della revisione delle guide a un solo task, quello attuale sulle "guide da controllare", eliminando le altre categorie e i relativi avvisi; la revisione ordinaria avverrà "dietro le quinte", con un avviso solo per gli ultimi 2 anni prima che una guida diventi obsoleta o da adottare; aggiunta di altri tag di revisione, come l'attuale ONLY, per permettere maggiore flessibilità nella revisione di una guida, lasciando più tempo per le guide più complesse o integrate con altre;
  3. gestione automatica di Stub, Guide da adottare e Guide adottate; estendendo la durata in cui una guida può essere lasciata in queste categorie, ma automatizzando il passaggio da una categoria all'altra; inclusione del template di Adozione collettiva nel template di "Guida da adottare", con sintassi simile a quella prevista per il template Autori per le guide collettive;
  4. riduzione del tempo di validità di una verifica per release volatili, quali testing e unstable, in particolare durante l'anno di rilascio, in quanto l'informazione è meno rilevante quando non recente; e permettere la verifica per la stable che sta per essere rilasciata (solo nell'anno di rilascio), così da portarsi un po' avanti con la revisione delle guide; ciò si può fare in automatico, senza bisogno di modificare il template più di una volta, come già adesso, quando avverrà il rilascio; resterebbero escluse (ossia trattate come adesso), in automatico, le guide scritte solo per una versione volatile;
  5. rendere deprecata la compatibilità per tutte le versione per le guide di nuova stesura, e sostituita con sintassi diversa, per le guide relative a repository (di cui si aggiornano in automatico le informazioni relative ai codename), guide teoriche e quelle relative a pacchetti di sistema e/o che non hanno subito modifiche sostanziali; a seguito di revisione delle guide che ne fanno uso, la vecchia compatibilità per tutte le versione sarà eliminata dal template "Versioni compatibili";
  6. le guide da adottare, ma non adottate, saranno spostate nel namespace Old come quelle obsolete, e il progetto adozione guide diverrebbe complementare a quello di revisione, volto a dare evidenza e a favorire il recupero delle guide obsolete più meritevoli (fermo restando che tutte possono essere adottate); inoltre tutte le guide obsolete, alpiù estendendo di un paio di anni quelle relative ad hardware obsoleto, saranno spostate nel namespace Old al momento in cui divengono obsolete (sempre previa segnalazione sul forum);
  7. documentazione di tutto quanto (sul wiki e in Lab per i vecchi thread), anche riguardo quello che avviene a livello di codice MediaWiki, per le parti più complesse.

I vari task non (ri)partiranno prima di febbraio, quindi spero che chiunque voglia intervenire con proprie proposte, abbia il tempo per farlo.

Buone feste e ci si risente al prossimo anno! ;)
Ricordarsi di modificare il primo messaggio della discussione per aggiungere [RISOLTO] prima del titolo, quando conclusa.

Wiki: APT e Repository, Comandi utili, Collabora.
Manuali di Debian 10 "buster" (PC): installazione, aggiornamento da versione 9.
Avatar utente
HAL 9000
wiki member
wiki member
 
Messaggi: 1547
Iscritto il: 10/08/2009, 10:01

Torna a Guide@Debianizzati.Org

Chi c’è in linea

Visitano il forum: Nessuno e 1 ospite