angular / angular/components

docs-bug(core): Missing documentation about elevation since v19.1

Aperta
#30,918 3 commenti 2 reazioni 0 assegnatari Vedi su GitHub
area: material/core docs P3
Lingua principale
TypeScript
Stelle
25k
Fork
6.8k
Merge medio
1g 8h
PR unite (30g)
91

Descrizione

### Documentation Feedback

In v18, we had https://v18.material.angular.io/guide/elevation that documented in depth what is, and how to use, elevations in Material.

Since 5753ce24a3e3bf743a9fc9f471eff46b85a7817b, and v19.1 that content is declared to have been moved to https://material.angular.io/guide/theming. However that new page does not even include the term "elevation" at all. So we cannot even know whether classes such as `mat-elevation-z2` are still supported, and even less how to make them work (via `@include mat.elevation-classes();`).

If this is something that has been deprecated (which does not seems to be the case when reading code), then it should at least be mentioned as such. Otherwise the original documentation should be restored.

Would you accept a PR that restore previous documentation, but included on the new https://material.angular.io/guide/theming ?

### Affected documentation page

https://v18.material.angular.io/guide/elevation

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inizia confrontando la guida sull'elevation di v18 con la pagina corrente sul theming, quindi esamina la modifica alla documentazione indicata e i percorsi del codice relativi alle classi di elevation e al mixin mat.elevation-classes(). Il lavoro è completo quando la documentazione sul theming spiega il supporto corrente per l'elevation e il relativo utilizzo, oppure ne documenta esplicitamente la deprecazione, con la pagina interessata aggiornata di conseguenza.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
angular
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.