@@ -69,16 +69,16 @@ source distributions may include:
69
69
70
70
- having a consistent build process across all Python packages
71
71
72
- While it is usually possible to build packages from a git repository, there are
72
+ While it is usually possible to build packages from a Git repository, there are
73
73
a few important reasons to provide a static archive file instead:
74
74
75
75
- Fetching a single file is often more efficient, more reliable and better
76
- supported than e.g. using a git clone. This can help users with poor
76
+ supported than e.g. using a Git clone. This can help users with poor
77
77
Internet connectivity.
78
78
79
79
- Downstreams often use hashes to verify the authenticity of source files
80
80
on subsequent builds, which require that they remain bitwise identical over
81
- time. For example, automatically generated git archives do not guarantee
81
+ time. For example, automatically generated Git archives do not guarantee
82
82
this, as the compressed data may change if gzip is upgraded on the server.
83
83
84
84
- Archive files can be mirrored, reducing both upstream and downstream
@@ -88,7 +88,7 @@ a few important reasons to provide a static archive file instead:
88
88
89
89
- Explicitly publishing archive files can ensure that any dependencies on version control
90
90
system metadata are resolved when creating the source archive. For example, automatically
91
- generated git archives omit all of the commit tag information, potentially resulting in
91
+ generated Git archives omit all of the commit tag information, potentially resulting in
92
92
incorrect version details in the resulting builds.
93
93
94
94
How?
@@ -108,7 +108,7 @@ separate archives.
108
108
109
109
A good idea is to **use your source distribution in the release workflow **.
110
110
That is, build it first, then unpack it and perform all the remaining steps
111
- using the unpacked distribution rather than the git repostiry — run tests,
111
+ using the unpacked distribution rather than the Git repostiry — run tests,
112
112
build documentation, build wheels. This ensures that it is well-tested,
113
113
and reduces the risk that some users would hit build failures or install
114
114
an incomplete package.
0 commit comments