Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs-bug(COMPONENT): I can no longer view the docs with m2 specs (the default styles) for version v17.X #28787

Open
Kerrick opened this issue Mar 27, 2024 · 4 comments
Labels
docs This issue is related to documentation P3 An issue that is relevant to core functions, but does not impede progress. Important, but not urgent

Comments

@Kerrick
Copy link

Kerrick commented Mar 27, 2024

Documentation Feedback

The version switcher on the docs site allows me to switch between latest and v16, but not between latest and v17.1, which is the version of Angular Material before the components began switching to m3 specs. Because v16 is not 1:1 compatible with v17, this means there's no way to view the documentation for a version that I (and probably many others) am stuck using for an indefinite period of time.

Affected documentation page

https://material.angular.io/components/categories

@Kerrick Kerrick added docs This issue is related to documentation needs triage This issue needs to be triaged by the team labels Mar 27, 2024
@Kerrick
Copy link
Author

Kerrick commented Mar 27, 2024

See also: #28788

@json-derulo
Copy link
Contributor

Valid point, it's a bit confusing that the v17.3 docs app is already on M3 while all v17.3 projects have M2 by default.

@Kerrick
Copy link
Author

Kerrick commented Mar 28, 2024

I misunderstood that both were available; rather than making available version 17.1, it would also be fine if there was another way to switch to m2 on latest 17.x in the docs. Ideally that way would also be in the URL so one can send coworkers links to either one specifically.

@Yberion
Copy link

Yberion commented Mar 29, 2024

Yeah, it would be good to have the last Angular 17 version of Angular Material with m2.

It would be awesome to have something like that:

  • ...
  • 17.3.1 (latest) M3
  • 17.3.1 (latest)
  • v16
  • ...

Starting from 17.3.1 (latest) M3, all new version of the doc would be m3. So for example the next version will be 18.0.0 (latest) and it will use m3.

Or it would be even better to have the possibility to switch from m2 to m3 at runtime (I don't even know if it's possible).

@Kerrick Kerrick changed the title docs-bug(COMPONENT): v17.1 (the last version to omit m3) is not present in version switcher docs-bug(COMPONENT): I can no longer view the docs with m2 specs (the default styles) for version v17.X Mar 29, 2024
@amysorto amysorto added P3 An issue that is relevant to core functions, but does not impede progress. Important, but not urgent and removed needs triage This issue needs to be triaged by the team labels May 7, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs This issue is related to documentation P3 An issue that is relevant to core functions, but does not impede progress. Important, but not urgent
Projects
None yet
Development

No branches or pull requests

4 participants