angular / angular/components

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

Ouverte
#30,918 3 commentaires 2 réactions 0 personnes assignées Voir sur GitHub
area: material/core docs P3
Langage dominant
TypeScript
Étoiles
25k
Forks
6.8k
Merge moyen
1 j 8 h
PR mergées (30 j)
91

Description

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

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

Commencez par comparer le guide elevation de v18 avec la page actuelle sur le theming, puis examinez la modification de documentation référencée ainsi que les chemins de code des classes elevation et du mixin mat.elevation-classes(). Le travail est terminé lorsque la documentation sur le theming explique la prise en charge actuelle d'elevation et son utilisation, ou documente explicitement sa dépréciation, avec la page concernée mise à jour en conséquence.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
angular
Domaine
documentation
Type d'issue
Documentation
Difficulté
2/5
Temps estimé
1-3 heures
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
35/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.