Anonymous avatar Anonymous committed 4432b16

improve wording of Distribution term explanation

Comments (0)

Files changed (1)

source/glossary.txt

     Distribution
         A Python distribution is a versioned compressed archive file
         that contains Python packages, modules, and other resource
-        files. The distribution file is what an end-user will downloaded
+        files. The distribution file is what an end-user will download
         from the internet and install.
         
-        In other fields of computing, a distribution is often called a
-        package. For example, Mac OS X and Debian call these files
-        package files. However, in Python, the term package refers to an
-        importable directory. In order to distinguish between these two
-        concepts, the compressed archive file containing code is called
-        a distribution.
+        A distribution is often also called a package. This is the term
+        commonly used in other fields of computing. For example, Mac OS X
+        and Debian call these files package files. However, in Python, the
+        term package refers to an importable directory. In order to
+        distinguish between these two concepts, the compressed archive file
+        containing code is called a distribution.
         
-        It is not uncommon in Python to refer to a distribution using the
-        term package. While the two meanings of the term package is not always
-        100% unambigous, the context of the term package is usually sufficient
-        to distinguish the meaning of the word. For example, the python
-        installation tool pip is an acronym for "pip installs packages",
-        while technically the tool installs distribution files, the name
-        package is used as it's meaning is more widely understood.
+        However, it is not uncommon in Python to refer to a distribution
+        using the term package. While the two meanings of the term package
+        is not always 100% unambigous, the context of the term package is
+        usually sufficient to distinguish the meaning of the word. For
+        example, the python installation tool pip is an acronym for
+        "pip installs packages", while technically the tool installs
+        distributions, the name package is used as it's meaning is more
+        widely understood. Even the site where distributions are distributed
+        at is called the Python Package Index (and not the Python Distribution
+        Index).
 
     Distutils
         A standard and basic package that comes with the Python
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.