Skip to content

Documentation: Strengthen warning about import * usage in modules tutorial #137009

@yusuaois

Description

@yusuaois

Documentation

In Doc/tutorial/modules.rst, the current wording about import * usage is not sufficiently strong:

- "However, it is okay to use it to save typing in interactive sessions."

This phrasing has two main issues:

- Understates risks: Framing it as "okay" minimizes the potential problems with wildcard imports

- Incomplete guidance: Fails to explicitly warn against using this pattern in production code

- Ambiguous justification: "Save typing" implies convenience is the primary consideration, ignoring namespace pollution risks

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation in the Doc dir

    Projects

    Status

    Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      pFad - Phonifier reborn

      Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

      Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


      Alternative Proxies:

      Alternative Proxy

      pFad Proxy

      pFad v3 Proxy

      pFad v4 Proxy