Differences between revisions 612 and 710 (spanning 98 versions)
Revision 612 as of 2019-08-21 01:45:35
Size: 10306
Editor: PaulWise
Comment: add a paragraph about Self-service buildd givebacks
Revision 710 as of 2021-12-17 23:57:58
Size: 6814
Comment: pep517 build plugin announcement
Deletions are marked like this. Additions are marked like this.
Line 10: Line 10:
This wiki page collects small news that all developers should know but that are not worth a dedicated mail to debian-devel-announce. Follow the template "Example of news" and add your news below it. See [[/Help]] for more information on how to write entries. If you have any questions, please ask the [[Teams/Publicity|publicity team]] or the [[https://lists.debian.org/debian-l10n-english/|the Debian English localisation mailing-list]]. This wiki page collects small news that all developers should know but that are not worth a dedicated mail to debian-devel-announce. Follow the template "Example of news" and add your news below it. If there are some other items already, please sort your item in descending order of importance to the Debian development community. See [[/Help]] for more information on how to write entries. If you have any questions, please ask the [[Teams/Publicity|publicity team]] or the [[https://lists.debian.org/debian-l10n-english/|Debian English localisation mailing-list]].
Line 12: Line 12:
If you are able to post to debian-devel-announce (all Debian members can) and there are 5 or more items below, you might want to send out the news. To send out a new issue, you can use this [[https://anonscm.debian.org/git/publicity/devnews.git/plain/generate-email|helper script]] to generate the email version of this page. After generating the mail, proof-read it, correct any spelling, formatting or grammatical errors and send out the mail. Once the mail is sent and archived, please delete the items that were sent, add a link to the archived mail in the [[#issues|Previous news]] section and mention the mail in ProjectNews. If you are able to post to debian-devel-announce (all Debian members can) and there are 5 or more items below, you might want to send out the news. To send out a new issue, you can use this [[https://salsa.debian.org/publicity-team/devnews/raw/master/generate-email|helper script]] to generate the email version of this page. After generating the mail, proof-read it, correct any spelling, formatting or grammatical errors and send out the mail. Once the mail is sent and archived, please delete the items that were sent, add a link to the archived mail in the [[#issues|Previous news]] section and mention the mail in ProjectNews.
Line 20: Line 20:
== Self-service buildd givebacks == === Python Packages: pep517 build tool ===
Line 22: Line 22:
Philipp Kern has [[https://debblog.philkern.de/2019/08/alpha-self-service-buildd-givebacks.html|created]] an *experimental* service that allows Debian members to perform self-service retries of failed package builds (aka give-backs). This service aims to reduce the time it takes for give-back requests to be processed, which was done manually by the wanna-build admins until now. The service is authenticated using the [[https://sso.debian.org/|Debian Single Signon]] service. Debian members are still expected to act responsibly when looking at build failures; do your due diligence and try reproducing the issue on a porterbox first. Access to this service is logged and logs will be audited by the admins. The Python world has developed new standards for building and distributing modules. You'll often see a pyproject.toml file instead of a setup.py that you used to get. pybuild now has support for building these packages with the pep517 plugin. See [[https://lists.debian.org/msgid-search/20211217235213.ub56dvrdkiwgjcww@satie.tumbleweed.org.za|this message for details]].
Line 24: Line 24:
-- Paul Wise

=== Debian Developers Reference now maintained as ReStructuredText ===

After 22 years of the Debian Developers Reference being maintained as an SGML document, the sources are now maintained as ReStructuredText, while the translations remain .po files.

Please note that this is work in progress and that there will be bugs.
Please do file them, with or without patches.

Big kudos and many thanks to Osamu Aoki for doing most of the work on this. Obviously also many thanks to everyone else involved, both upstream and in Debian!

-- Holger Levsen

=== Superficial package testing ===

A number of Debian packages use `cmd --version` or `cmd --help` as an autopkgtest. This solely tests the command-line and options parsing of the command but does not test any significant functionality of the command. Such tests do not provide significant test coverage, so if they pass, that does not necessarily mean that the package under test is actually functional in any useful way. autopkgtest supports marking such tests with the [[https://salsa.debian.org/ci-team/autopkgtest/blob/master/doc/README.package-tests.rst#L302|superficial tag]] for the Restrictions field. Please check your package tests and make sure they are using {{{Restrictions: superficial}}} where appropriate. A request for a lintian complaint for common cases of this issue has been [[https://bugs.debian.org/932862|filed]] but many of the superficial tests in Debian will not be detectable by lintian because doing so would require parsing shell and deciding what it tests and if that is superficial or not.

Superficial tests are useful to detect severe breakage but please also ensure that your package has some non-superficial tests that actually test significant functionality of your package.

-- Paul Wise

=== Scope of debian-mentors broadened to help with infrastructure questions ===

Debian-mentors explicitly endorses questions about Debian infrastructure projects on the [[https://lists.debian.org/debian-mentors/|mailinglist]] and [[irc://irc.debian.org/debian-mentors|IRC channel]]. This is the result of a [[https://lists.debian.org/debian-project/2019/06/msg00040.html|discussion]] on debian-project and debian-mentors. There seems to be some consensus that such infrastructure projects are the ones in Debian that most badly need more contributors. At the same time, our infrastructure projects/teams have a rather high entry barrier. Apparently, one reason is that understaffed teams with high workload usually lack the time and resources to mentor new contributors. This basically means that new contributors can send their questions regarding Debian infrastructure projects to debian-mentors, *and* infrastructure groups that lack the time to reply to newbie questions are invited to redirect those questions there.

The [[https://wiki.debian.org/DebianMentorsFaq#Infrastructure_Projects|debian-mentors FAQ]] has been updated accordingly.

-- Jonas Meurer

=== Hiding package tracker action items ===

The Debian package tracker lists action items for each package. Some of these may not apply to individual visitors to the package tracker. For example, people who have enough packages to maintain already probably don't want to see suggestions to adopt orphaned dependencies of packages. The Debian package tracker [[https://salsa.debian.org/qa/distro-tracker/commit/332a4cdb7c020d504cbb576d4b45f4113b656a1c|now]] applies an action-item-* CSS class to each action item representing the type of the action item. You can use this via the [[https://add0n.com/stylus.html|Stylus WebExtension]] (not [[https://bugs.debian.org/904577|yet]] in Debian) or [[http://kb.mozillazine.org/index.php?title=UserContent.css|Firefox's userContent.css]]. For example, this CSS will hide items suggesting adoption of orphaned dependencies:

{{{
.action-item-debian-depneedsmaint { display: none; }
}}}

-- Paul Wise
-- Debian Python People
Line 66: Line 29:
[[https://lists.debian.org/debian-devel-announce/2021/10/msg00000.html|56]]
[[https://lists.debian.org/debian-devel-announce/2021/04/msg00005.html|55]]
[[https://lists.debian.org/debian-devel-announce/2021/02/msg00005.html|54]]
[[https://lists.debian.org/debian-devel-announce/2020/10/msg00003.html|53]]
[[https://lists.debian.org/debian-devel-announce/2020/08/msg00003.html|52]]
[[https://lists.debian.org/debian-devel-announce/2020/04/msg00016.html|51]]
[[https://lists.debian.org/debian-devel-announce/2020/01/msg00001.html|50]]
<<BR>>
[[https://lists.debian.org/debian-devel-announce/2019/08/msg00003.html|49]]

Translation(s) : English - español - Français - 日本語

News for Debian developers

This wiki page collects small news that all developers should know but that are not worth a dedicated mail to debian-devel-announce. Follow the template "Example of news" and add your news below it. If there are some other items already, please sort your item in descending order of importance to the Debian development community. See /Help for more information on how to write entries. If you have any questions, please ask the publicity team or the Debian English localisation mailing-list.

If you are able to post to debian-devel-announce (all Debian members can) and there are 5 or more items below, you might want to send out the news. To send out a new issue, you can use this helper script to generate the email version of this page. After generating the mail, proof-read it, correct any spelling, formatting or grammatical errors and send out the mail. Once the mail is sent and archived, please delete the items that were sent, add a link to the archived mail in the Previous news section and mention the mail in ProjectNews.

Example of news

This is a sample news. Copy it and edit the title, content and signature... You can use links like this. Put real news below this sample.

-- Your Name

Python Packages: pep517 build tool

The Python world has developed new standards for building and distributing modules. You'll often see a pyproject.toml file instead of a setup.py that you used to get. pybuild now has support for building these packages with the pep517 plugin. See this message for details.

-- Debian Python People

Previous news

56 55 54 53 52 51 50
49 48 47 46 45 44 43 42 41 40
39 38 37 36 35 34 33 32 31 30
29 28 27 26 25 24 23 22 21 20
19 18 17 16 15 14 13 12 11 10
9 8 7 6 5 4 3 2 1


CategoryPermalink