Zen

Source string Source string

971/10000 · 971

The string is read only.

English Actions
upstream (noun)
In free and open source projects, the _upstream_ of a program or set of programs is the project that develops those programs. Fedora is _downstream_ of those projects. This term comes from the idea that water and the goods it carries float downstream and benefit those who are there to receive it.
to upstream (verb)
A short-hand way of saying "push changes to the upstream project".
What are deviations from upstream?
*Patches*: Patches are the most common and obvious type of change from upstream.
Patches might be written by the package maintainer,
cherry picked or backported from upstream
or picked from other distributions.
*Running sed or equivalent on a spec file*:
While this change is less obvious,
it should be considered functionally equivalent to a patch
for the purposes of this guide.
Also a patch is preferable
because running sed can sometimes change the software in unintended ways
especially when the package maintainer is pushing a new upstream release as an update
and such changes might not be obvious compared to a failed patch.
Desktop files, systemd unit files, etc. are sometimes added as *additional sources*: If you do this as a package maintainer, you need to notify upstream and ideally get them included as part of the upstream source. Maintaining them separately often involves additional maintenance.
*Configuration options*:
For instance, if a particular upstream software allows both MySQL and Postgres as a database backend,
other distributions might have picked Postgres
and Fedora package might be configured to use the MySQL backend by default instead.
If upstream or other distributions are favoring one of the options over the others,
talk to them,
find out why
and rely on well tested and consistent options as much as possible.
*Underlying libraries and other software components*:
Even without intentional modifications,
software in Fedora can still be different from upstream or other distributions,
due to precise library versions or other software components your package depends on.
For instance, Firefox may expose a sqlite bug,
and Fedora might be the only distribution building that precise version of Firefox
against that specific version of sqlite.
You should talk to upstream and find out whether there are any such known issues,
and search through upstream bug trackers
or other popular distribution bug trackers
to figure out such problems.
*Miscellaneous*:
The above list is not comprehensive.
Even seemingly minor changes like the specific desktop theme or fonts
can exhibit bugs in other software,
or can expose a bug in the theme or font
but only with some specific software.
For instance, LibreOffice might have a problem displaying a list
when using the Adwaita theme and Dejavu font.
When analyzing issues,
make sure you consider the impact of every change
either in Fedora or by users themselves.
Why push changes upstream?
*Common Benefit And Reduced Maintenance Burden*:
When Fedora carries patches that are specific to Fedora or deviations from upstream projects,
those patches are not shared by every distribution.
This puts the burden of maintaining those patches on Fedora,
which includes keeping those patches in a functional state
by rewriting or forward-porting them for every upstream release.
This effort can quickly add up to be overwhelming,
while not being in the spirit of sharing the benefits
(as well as the effort in maintaining)
free and open source software.
*Documentation*:
Upstream projects are documented formally
(in the form of man/info pages and longer guides)
and informally in many user forums or mailing lists as answers to user questions.
Deviations from upstream projects can thus confuse end users and upstream developers
when those patches cause changes in behavior that are Fedora specific
and not documented properly,
even where the formal documentation
(such as man pages)
are also patched to describe the changes.
*Translations*:
Maintaining translations upstream gains the advantage of established translation communities,
which are most likely more experienced with the project terms.
Downstream projects benefit when using those translations.
In addition, it lifts the burden of hosting,
and of the need to merge often from upstream to downstream and back again.
To make sure translation work continues upstream.
Any string changes that were introduced by patches should be maintained by the downstream community.
*Upstream Acceptance*:
Fedora is downstream of many thousands of software projects.
Much of this software is packaged by maintainers who are not programmers
or lack expertise in the language(s) the software is written in.
In some cases the software has a large and complex codebase
(such as the kernel or Libreoffice)
and the package maintainers might not have the same level of understanding in all areas
compared to subsystem maintainers or upstream developers.
For this and other reasons,
Fedora needs the acceptance of upstream software developers.
These developers may view any significant patches as a fork
or refuse to take bug reports from Fedora users
due to the differences in the codebase.
Fedora as a project strives to be welcoming and cooperative with upstream developers
as much as possible.
We must avoid Fedora specific patches
and any patches that are useful should be sent upstream to these developers
via mailing lists, bug trackers, or direct email.
*Quality Assurance*: Patches that are accepted upstream
are usually reviewed or tested by many people
including developers and testers.
This includes testing by other GNU/Linux distributions.
A deviation from the common codebase used by many
is a potential chance of introducing a regression that is specific to Fedora.
*Security*:
A special case of the "Quality Assurance" issue
is that changes that have surprising security implications
are more likely to be detected by upstream
(who often have deeper knowledge of the program).
*Fast incremental improvements*:
Staying close to upstream versions is helpful
when doing version bumps for updates that bring in new features.
This prevents tedious backporting of only security and bug fixes.
Deviations from upstream can significantly hamper the speed of delivering improvements
from new versions to end users.
However, regressions are to be avoided,
and potential improvements and new features must be carefully assessed
against the risk of harming the users experience.
Refer to xref:fesco::Updates_Policy.adoc[Updates Policy] for more details.
*ABI or API Deviations*:
Patches that introduce a new application binary interface (ABI)
or application program interface (API)
must be especially avoided,
even if the ABI/API changes are planned to land upstream.
When these patches get upstream
(if ever),
upstream developers might introduce changes in the ABI/API
during the code review process before merging the code.
This could break other software in the repository
that makes use of the Fedora-patched ABI/API.
*Direct End User Feedback*:
When users run into problems with any software that is in Fedora,
they can report the problems directly upstream.
By not deviating from upstream,
it remains a central location for all bug reports on that software,
leaving Fedora package maintainers to concentrate on good packaging
instead of acting in between users and upstream issues.
Tips On Upstreaming Patches
Talk to upstream. Maintaining a regular flow of communication with the upstream project is helpful in understanding the upstream developers well, and encourages them to be more responsive to your requests. It also helps in understanding technical issues, such as how they prefer patches to be submitted.
Make the patches generic enough to be maintained by upstream developers. Explain the need for your patches, that is, what bugs they fix or what features they add. Any references to bugzilla reports or user requests can be quite useful for the developers who receive your patches.
Do not consider any change to be too small to be sent upstream. Even minor changes like fixing a permission problem in a file or excluding an empty file can and should be reported upstream even if upstream does not necessarily act on all of them quickly.
Divide patches into small and independent chunks that remain functional, so they can be understood, reviewed, and accepted or rejected individually.
If the patch introduces new strings or changes existing ones, make the changes as generic as possible.
Fix your coding style to match the upstream project's guidelines. This might seem trivial but many upstream projects insist on following their guidelines so that their codebase looks internally self consistent and is more maintainable.
Where possible, encourage upstream point-releases that fix bugs and security issues only, to avoid the possibility of regressions.
Test your changes as thoroughly as you can before you send them upstream. Broken patches leave a long-lasting bad impression.
Be patient and cooperative. If feedback is offered, discuss changes, answer questions, and provide revisions that fix any problems. Don't flame or argue unnecessarily with upstream developers. The overall goal is persuade upstream developers to get your patches committed upstream and not to demonstrate "who is better." Don't forget the human element in these conversations. If necessary, we will have to carry some patches downstream to enforce our policies even if upstream does not agree with us at that point.

Loading…

User avatar None

String updated in the repository
*Upstream Acceptance*:
Fedora is downstream of many thousands of software projects.
Much of this software is packaged by maintainers who are not programmers
or lack expertise in the language(s) the software is written in.
In some cases the software has a large and complex codebase
(such as the kernel or Libreoffice)
and the package maintainers might not have the same level of understanding in all areas
compared to subsystem maintainers or upstream developers.
For this and other reasons,
Fedora needs the acceptance of upstream software developers.
These developers may view any significant patches as a fork
or refuse to take bug reports from Fedora users
due to the differences in the codebase.
Fedora as a project strives to be welcoming and cooperative with upstream developers
as much as possible.
We must avoid Fedora specific patches
and any patches that are useful should be sent upstream to these developers
via mailing lists, bug trackers, or direct email.
*Upstream Acceptance*:
Fedora is downstream of many thousands of software projects.
Much of this software is packaged by maintainers who are not programmers
or lack expertise in the language(s) the software is written in.
In some cases the software has a large and complex codebase
(such as the kernel or Libreoffice)
and the package maintainers might not have the same level of understanding in all areas
compared to subsystem maintainers or upstream developers.
For this and other reasons,
Fedora needs the acceptance of upstream software developers.
These developers may view any significant patches as a fork
or refuse to take bug reports from Fedora users
due to the differences in the codebase.
Fedora as a project strives to be welcoming and cooperative with upstream developers
as much as possible.
We must avoid Fedora specific patches
and any patches that are useful should be sent upstream to these developers
via mailing lists, bug trackers, or direct email.
10 months ago
Browse all string changes

Things to check

Unpluralised

The string is used as plural, but not using plural forms

Reset

Glossary

English English
No related strings found in the glossary.

String information

Source string description
type: Plain text
Flags
no-wrap, placeholders:r"`[\w\d -_<>(){}\[\]@$;.\*+=]*`":r"(link:)?https?://[\w\d\-_#?&%=\./]*":r"xref:[\w\d\-_/]*\.adoc(#[\w\d\-_/]*)?", read-only
Source string location
./pages/Staying_Close_to_Upstream_Projects.adoc:131
String age
10 months ago
Last updated
10 months ago
Source string age
10 months ago
Translation file
pot/master/pages/Staying_Close_to_Upstream_Projects.pot, string 18