Skip to content

Suggestion: Update Import Maps documentation link to official HTML Standard #3272

@naitokosuke

Description

@naitokosuke

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:

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!

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions