angular / angular/components

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

Abierto
#30,918 3 comentarios 2 reacciones 0 asignados Ver en GitHub
area: material/core docs P3
Lenguaje dominante
TypeScript
Estrellas
25k
Forks
6.8k
Merge medio
1 d 8 h
PR fusionados (30 d)
91

Descripción

### 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

Guía de contribución

Abrir la guía de contribución

Línea de trabajo

Comienza comparando la guía de elevation de v18 con la página actual de theming; después, inspecciona el cambio de documentación referenciado y las rutas de código de las clases de elevation y del mixin mat.elevation-classes(). Se considera terminado cuando la documentación de theming explica la compatibilidad actual con elevation y su uso, o documenta explícitamente su obsolescencia, con la página afectada actualizada en consecuencia.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
angular
Área
documentation
Tipo de issue
Documentación
Dificultad
2/5
Tiempo estimado
1-3 horas
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
35/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.