Skip to content

Commit 08c70e8

Browse files
committed
Elaborate a bit more on why it's good to help downstreams
1 parent 00f39e5 commit 08c70e8

1 file changed

Lines changed: 13 additions & 3 deletions

File tree

source/discussions/downstream-packaging.rst

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,12 +13,22 @@ of other packaging ecosystems. These repackaging efforts are collectively called
1313
*downstream* packaging (your own efforts are called *upstream* packaging),
1414
and include such projects as Linux distributions, Conda, Homebrew and MacPorts.
1515
They often aim to provide good support for use cases that cannot be handled
16-
via Python packaging tools alone, such as good integration with non-Python
17-
software.
16+
via Python packaging tools alone, such as **good integration with non-Python
17+
software**.
1818

1919
This discussion attempts to explain how downstream packaging is usually done,
2020
and what challenges are downstream packagers facing. It ultimately aims to give
21-
you some hints on how you can make downstream packaging easier.
21+
you some hints on how you can **make downstream packaging easier**.
22+
23+
Establishing a good relationship between software maintainers and downstream
24+
packagers can bring mutual benefits. Downstreams are often willing to **share
25+
their experience, time and hardware** to improve your package. They are
26+
sometimes in a better position to see **the bigger picture**, and to provide
27+
you with **information about other packages** that would otherwise require you
28+
to put significant effort to obtain. Packagers often can **find bugs** before
29+
your users hit them on production, **provide bug reports of good quality**
30+
and **supply patches** whenever they can. For example, they are often
31+
in the vanguard when **a new Python version** comes out.
2232

2333
Please note that downstream builds include not only binary redistribution,
2434
but also source builds done on user systems, in source-first distributions

0 commit comments

Comments
 (0)