docs icon indicating copy to clipboard operation
docs copied to clipboard

Suggestion: Update Import Maps documentation link to official HTML Standard

Open naitokosuke opened this issue 4 months ago • 1 comments

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!

naitokosuke avatar Aug 03 '25 22:08 naitokosuke

On this page

https://vuejs.org/guide/scaling-up/ssr.html#code-structure

Support usage like import * from 'vue' in the browser by adding an Import Map to the HTML shell.

naitokosuke avatar Sep 11 '25 05:09 naitokosuke