-
Notifications
You must be signed in to change notification settings - Fork 4.8k
Description
Hello Vue.js Team!
First of all, thank you for maintaining such excellent documentation for the Vue.js ecosystem. The docs have been incredibly helpful for developers worldwide.
Suggestion
I noticed that the Vue.js documentation currently references the WICG/import-maps repository when discussing Import Maps.
Since this repository has been archived and Import Maps are now part of the official HTML Standard, it might be helpful to update the documentation to reflect this change.
Current Documentation
The docs mention:
Support usage like import * from 'vue' in the browser by adding an Import Map to the HTML shell.
Currently linking to: https://github.com/WICG/import-maps (archived)
Suggested Update
Consider updating the reference to point to the current official resources:
- HTML Standard: https://html.spec.whatwg.org/multipage/webappapis.html#import-maps
- MDN Documentation: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type/importmap
Pros & Cons
Pros of updating the link:
- Direct access to practical documentation: Users can immediately access MDN's comprehensive documentation with examples and browser compatibility information
- Up-to-date information: Links to current, maintained resources rather than archived proposals
- Better user experience: Developers get actionable information without extra navigation steps
Cons of the current approach:
- Educational value: The current link allows users to understand the standardization process - they can see that Import Maps were once a proposal that has now been archived and became part of the official HTML Standard
- Historical context: Provides insight into how web standards evolve from proposals to official specifications
Rationale
The archived repository now states:
Import maps are now part of the HTML Standard. You can also read about them on MDN.
While the current approach has educational merit, linking directly to the official specification would provide users with the most practical and up-to-date information for implementing Import Maps.
Thank you for considering this suggestion!