File tree Expand file tree Collapse file tree 1 file changed +12
-0
lines changed Expand file tree Collapse file tree 1 file changed +12
-0
lines changed Original file line number Diff line number Diff line change @@ -134,6 +134,18 @@ build tag
134
134
the first item being the initial digits as an ``int ``, and the
135
135
second item being the remainder of the tag as a ``str ``.
136
136
137
+ .. warning ::
138
+
139
+ Build numbers are not a part of the distribution version and thus are difficult
140
+ to reference externally, especially so outside the Python ecosystem of tools and standards.
141
+ A common case where a distribution would need to referenced externally is when
142
+ resolving a security vulnerability.
143
+
144
+ Due to this limitation new distributions which need to be referenced externally
145
+ **should not ** use build numbers when building the new distribution.
146
+ Instead a **new distribution version ** should be created for such cases.
147
+
148
+
137
149
language implementation and version tag
138
150
E.g. 'py27', 'py2', 'py3'.
139
151
You can’t perform that action at this time.
0 commit comments