angular / angular/components

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

Open
#30,918 3 comments 2 reactions 0 assignees View on GitHub
area: material/core docs P3
Dominant language
TypeScript
Stars
25k
Forks
6.8k
Avg merge
1d 8h
Merged PRs (30d)
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

Contributor guide

Open the contributing guide

Research direction

Start by comparing the v18 elevation guide with the current theming page, then inspect the referenced documentation change and the code paths for elevation classes and the mat.elevation-classes() mixin. Done means the theming documentation explains the current elevation support and usage, or explicitly documents its deprecation, with the affected page updated accordingly.

Written by the indexing model from the issue text.

Assessment

Tech stack
angular
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.