From 0a2460f42e978333c15079e703f37650c499a8b4 Mon Sep 17 00:00:00 2001 From: zlq500 Date: Mon, 16 Feb 2026 00:03:30 +0800 Subject: [PATCH] docs: Add note recommending grid over pack in tkinter documentation Add a note at the beginning of 'The Packer' section to recommend using grid geometry manager over pack for new code, as grid is easier to use and helps create more appealing layouts. Fixes #93501 --- Doc/library/tkinter.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 805f619eab8c07..9a8c1c5d51f1b5 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -637,6 +637,11 @@ The Packer .. index:: single: packing (widgets) +.. note:: + For new code, using the :meth:`grid` geometry manager is recommended over + :meth:`pack`. While :meth:`pack` is equally powerful, :meth:`grid` is easier + to use and makes it less onerous to create layouts that look appealing. + The packer is one of Tk's geometry-management mechanisms. Geometry managers are used to specify the relative positioning of widgets within their container. In contrast to the more cumbersome *placer* (which is