{"id":388,"date":"2021-08-30T09:52:12","date_gmt":"2021-08-30T09:52:12","guid":{"rendered":"http:\/\/thomas.goirand.fr\/blog\/?p=388"},"modified":"2021-08-30T09:55:28","modified_gmt":"2021-08-30T09:55:28","slug":"developers-reference-needs-love","status":"publish","type":"post","link":"http:\/\/thomas.goirand.fr\/blog\/?p=388","title":{"rendered":"developers-reference needs love"},"content":{"rendered":"\n

During Debconf, Holger, who’s one of the developers-reference maintainers, made a quick presentation that was explaining the developers-reference needs some love. Indeed, it has gathered dust, and some useful refresh would be very welcome. Holger pointed at the list of bugs:
https:\/\/bugs.debian.org\/src:developers-reference<\/p>\n\n\n\n

After having a quick look into that list, after Holger’s Debconf presentation, I wrote to him on IRC:<\/p>\n\n\n\n

<zigo> Many of the bugs you refered are indeed easily actionable, if all of us just try to help for one<\/em> bug, that’d be a huge improvement of that doc.<\/p>\n\n\n\n

Then, as I was waiting for the closing ceremony of Debconf, I thought I shouldn’t just say it, but actually do something about it. I decided to address https:\/\/bugs.debian.org\/793633 as I thought it was easy. In just a few minutes, I was able to do a first patch, as seen here:<\/p>\n\n\n\n

https:\/\/salsa.debian.org\/debian\/developers-reference\/-\/merge_requests\/27<\/a><\/p>\n\n\n\n

I wrote about it on IRC, and a few people helped with rephrasing what was there (thanks to Fil for correcting my English mistakes, and others for the content).<\/p>\n\n\n\n

Today, which is 2 days after the MR was opened, I have decided it was long enough and actually merged it, as I considered it was enough time to gather comments. So we now have a brand new shiny chapter about Backports and how to handle them. I’m sure that new part is perfectible, so do not hesitate, and do patch what I just wrote if you feel like you can do better.<\/p>\n\n\n\n

If I’m writing this blog post, this is not<\/strong> to promote myself. The goal is to promote the developers-reference manual and push others in Debian to do the same. Please do what Holger suggested, and what I just did: contribute to the document by addressing just one<\/strong> of the currently opened bugs. If all DDs do it, we’ll get a much nicer document, and help others to contribute to Debian.<\/p>\n\n\n\n

This is going to take less than 30 minutes of your time, and it is very much ok if you do this only once. It is really easy: just clone https:\/\/salsa.debian.org\/debian\/developers-reference\/ and write a patch. If you’re a DD, you can even merge your patch yourself once you’re satisfied with it.<\/p>\n","protected":false},"excerpt":{"rendered":"

During Debconf, Holger, who’s one of the developers-reference maintainers, made a quick presentation that was explaining the developers-reference needs some love. Indeed, it has gathered dust, and some useful refresh would be very welcome. Holger pointed at the list of bugs:https:\/\/bugs.debian.org\/src:developers-reference After having a quick look into that list, after Holger’s Debconf presentation, I wrote […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"_links":{"self":[{"href":"http:\/\/thomas.goirand.fr\/blog\/index.php?rest_route=\/wp\/v2\/posts\/388"}],"collection":[{"href":"http:\/\/thomas.goirand.fr\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/thomas.goirand.fr\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/thomas.goirand.fr\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/thomas.goirand.fr\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=388"}],"version-history":[{"count":4,"href":"http:\/\/thomas.goirand.fr\/blog\/index.php?rest_route=\/wp\/v2\/posts\/388\/revisions"}],"predecessor-version":[{"id":392,"href":"http:\/\/thomas.goirand.fr\/blog\/index.php?rest_route=\/wp\/v2\/posts\/388\/revisions\/392"}],"wp:attachment":[{"href":"http:\/\/thomas.goirand.fr\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=388"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/thomas.goirand.fr\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=388"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/thomas.goirand.fr\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=388"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}