Ciao, vi scrivo sperando di poter apportare il mio contributo al miglioramento della documentazione delle note di rilascio.
Stiamo aggiornando il nostro progetto da una versione precedente (22.0) all'ultima disponibile, e siamo incappati in due problemi che hanno richiesto del lavoro di revisione del codice e del progetto al solo scopo di mantenere il comportamento precedente dell'applicazione.
Mantenere sempre la retro-compatibilità è molto complesso, e da questo punto di vista avete fatto sempre un ottimo lavoro.
Però....
Nelle ultime versioni sono stati introdotte queste 2 novità/miglioramenti:
IDE: Merge di custom.css e custom3.js
IDE: Pannelli IMDB e flag lockable
Questi a mio avviso dovevano essere evidenziati come breaking change, rendendo chiaro a noi programmatori che avremmo dovuto prestare attenzione, ed attenderci del lavoro da fare.
Nel primo caso, chiunque avesse usato dei componenti, e definito JS o CSS custom, poteva trovarsi nella situazione di dover riscrivere e ristrutturare il contenuto dei propri file (vedi qui).
Nel secondo caso, c'era la concreta possibilità che molti dei programmatori che avessero usato dei pannelli IMDB, si trovassero dei pannelli con un funzionamento diverso rispetto al passato (vedi qui).
In entrambi i casi, pensare che nel 100% di casi sarebbe andato tutto liscio era "molto ottimistico".
A tutto questo si aggiunge il problema della Chilkat, che rende di fatto impossibile usare la propria versione, perchè la sovrascrivete sempre con la vostra (oppure ne aggiungete un'altra). Ogni tanto cambiate il comportamento di INDE a riguardo, costringendo sempre a stare molto attenti, se non a utilizzare work-around sempre diversi.
Ammettere breaking changes non è peccato, non ci troverei niente di male se fosse presente una sezione al pari di novità, migliorie, correzioni.
Pensateci, anche perchè, i problemi li incontriamo, documentati o meno. Il fatto che fossero nascosti tra le "novità" non rende la pillola meno amara, anzi.