Permalink a latest about docs-italia-theme

[pdavide]

@alexrj @atorin secondo me ogni documentazione dovrebbe avere un permalink che permetta di raggiungere l'ultima versione (stabile). Attraverso il tema non è possibile incidere sulla logica di generazione dei path che invece dipende proprio dal concetto di "versione" su RTD.
Per le "Linee guida di design" l'approccio adottato è quello descritto nel paragrafo Version control e release della documentazione, ma non è detto che questo modello si possa applicare a tutte le tipologie di documenti.
Dal punto di vista del tema, c'è una piccola accortezza che è stata implementata (con questo modulo) su "Linee guida di design" che fa in modo che se anche l'url è .../stable/..., nel badge della barra laterale è visualizzato il corretto numero di versione anziché la stringa "stable".

[alterat]

@alexrj grazie per la segnalazione.

Per quanto riguarda il CAD, posso aggiungere la versione latest senza particolari problemi. L'avevo eliminata per ragioni di "pulizia" delle versioni, ma capisco che questa strategia possa portare dei problemi.

In generale, concordo sulla possibilità di specificare meglio come taggare i documenti. Non so invece se valga la pena lavorare a livello di tema, ma su questo lascio la parola agli sviluppatori.

[alterat]

@pdavide sono d'accordo con l'approccio descritto nelle Linee guida, che abbiamo confermato anche nella Guida a Docs Italia.

La soluzione potrebbe essere di attivare, per ogni documento, sia la versione latest che stable, inserendo questa prescrizione nella Guida?

Il concetto di "versione" è legato secondo me al contenuto del documento, più che al suo aspetto esteriore, quindi al di là delle possibili difficoltà tecniche, non gestirei questo aspetto a livello di tema.