Differences between revisions 611 and 617 (spanning 6 versions)
Revision 611 as of 2019-07-30 02:41:20
Size: 9538
Editor: HolgerLevsen
Comment: move example back on top
Revision 617 as of 2019-08-21 09:57:53
Size: 5692
Editor: PaulWise
Comment: edition 49 sent
Deletions are marked like this. Additions are marked like this.
Line 20: Line 20:
=== 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
Line 60: Line 23:

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. See /Help for more information on how to write entries. If you have any questions, please ask the publicity team or the 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

Previous news

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