From 7c17051c3496a88d13fab693eb914a6a0085fd11 Mon Sep 17 00:00:00 2001 From: ron Date: Wed, 11 Feb 2026 12:49:09 -0500 Subject: [PATCH 1/2] doc: add seealso link to src-layout vs flat-layout discussion Add a ``.. seealso::`` cross-reference to the packaging.python.org discussion on src layout vs flat layout, using intersphinx rather than a raw URL. --- doc/en/explanation/goodpractices.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/en/explanation/goodpractices.rst b/doc/en/explanation/goodpractices.rst index 7c589b57033..d44c1623de0 100644 --- a/doc/en/explanation/goodpractices.rst +++ b/doc/en/explanation/goodpractices.rst @@ -150,6 +150,11 @@ which are better explained in this excellent `blog post`_ by Ionel Cristian Măr See :ref:`pytest vs python -m pytest` for more information about the difference between calling ``pytest`` and ``python -m pytest``. +.. seealso:: + + :doc:`packaging:discussions/src-layout-vs-flat-layout` + The Python Packaging User Guide discusses the trade-offs between the ``src`` layout and flat layout. + Tests as part of application code ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ From b2e93bc7ab8aee781785290ee07d3fc26d8cc67e Mon Sep 17 00:00:00 2001 From: ron Date: Wed, 11 Feb 2026 13:51:54 -0500 Subject: [PATCH 2/2] doc: use literal markup for "flat" layout for consistency --- doc/en/explanation/goodpractices.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/en/explanation/goodpractices.rst b/doc/en/explanation/goodpractices.rst index d44c1623de0..d8f68f56faf 100644 --- a/doc/en/explanation/goodpractices.rst +++ b/doc/en/explanation/goodpractices.rst @@ -153,7 +153,7 @@ which are better explained in this excellent `blog post`_ by Ionel Cristian Măr .. seealso:: :doc:`packaging:discussions/src-layout-vs-flat-layout` - The Python Packaging User Guide discusses the trade-offs between the ``src`` layout and flat layout. + The Python Packaging User Guide discusses the trade-offs between the ``src`` layout and ``flat`` layout. Tests as part of application code ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^