File tree Expand file tree Collapse file tree 2 files changed +10
-2
lines changed Expand file tree Collapse file tree 2 files changed +10
-2
lines changed Original file line number Diff line number Diff line change @@ -936,11 +936,17 @@ Glossary
936936      modules, respectively.
937937
938938   namespace package
939-       A :pep:  ` 420 `  : term:package ` which serves only as a container for
940-       subpackages.   Namespace packages may have no physical representation,
939+       A :term: `package ` which serves only as a container for subpackages. 
940+       Namespace packages may have no physical representation,
941941      and specifically are not like a :term: `regular package ` because they
942942      have no ``__init__.py `` file.
943943
944+       Namespace packages allow you to split single package across multiple directories or distributions.
945+       On the other hand, namespace packages have some drawbacks and pitfalls.
946+       Use :term: `regular package ` always when it fits your needs.
947+ 
948+       For more information, see :pep: `420 ` and :ref: `reference-namespace-package `.
949+ 
944950      See also :term: `module `.
945951
946952   nested scope
Original file line number Diff line number Diff line change @@ -123,6 +123,8 @@ Importing ``parent.one`` will implicitly execute ``parent/__init__.py`` and
123123``parent/three/__init__.py `` respectively.
124124
125125
126+ .. _reference-namespace-package :
127+ 
126128Namespace packages
127129------------------ 
128130
 
 
   
 
     
   
   
          
    
    
     
    
      
     
     
    You can’t perform that action at this time.
  
 
    
  
    
      
        
     
       
      
     
   
 
    
    
  
 
  
 
     
    
0 commit comments