1. Forum
  2. Usenet
  3. LINUX.DEBIAN.DEVEL

  • developers-reference "vs" wiki.debian.org/DebianMaintainer

    From Holger Levsen@21:1/5 to All on Thu Feb 10 12:50:01 2022
    hi,

    so Stephan Lachnit submitted an MR for developers-reference on Monday to document how to grant DM upload permissions, which I gladly merged, even
    though I was aware of "#653399: developers-reference: Please include a paragraph about Debian Maintainers (DM)" still being unresolved.

    Which lead me to (quoting from #-devel that day)

    < h01ger> stephanlachnit: now i'm wondering how much of
    https://wiki.debian.org/DebianMaintainer i should copy into
    developers-reference... i've seen you also documented the dcut
    commands there, which makes sense as it is now, though i'm not
    convinced it's good to have all the docs in two places
    < h01ger> so i'm also pondering about mostly adding a pointer to that wiki
    page to devref
    < h01ger> (the wiki and devref are both GPL2 licenced, so that part is easy :) < h01ger> feedback from anyone is welcome of course, not just stephan :)

    So what do you all think?

    I'm leaning towards explaining the basics in devref (mostly by copying bits from the wiki page) and adding a pointer to the wiki page, but if there's consensus that the wiki page is supposed to be made obsolete by *moving*
    the contents to src:devref and leaving a pointer on the wiki page, I could
    also do that.


    --
    cheers,
    Holger

    ⢀⣴⠾⠻⢶⣦⠀
    ⣾⠁⢠⠒⠀⣿⡁ holger@(debian|reproducible-builds|layer-acht).org
    ⢿⡄⠘⠷⠚⠋⠀ OpenPGP: B8BF54137B09D35CF026FE9D 091AB856069AAA1C
    ⠈⠳⣄

    The vision of self driving cars is nothing compared to the vision of no cars at all.

    -----BEGIN PGP SIGNATURE-----

    iQIzBAABCgAdFiEEuL9UE3sJ01zwJv6dCRq4VgaaqhwFAmIE+7EACgkQCRq4Vgaa qhy+OQ//TJa+CyARVM8ZofCDHZMqnirhuUUo7DlfwWSDfm80tJg0gt3v4lGoQc0d twksBlRdC8UHeIfXYBXssjvu8XEf/CMh3e8CJRbUhham0+3HrmsSDhum7jUb5T7a PvEC/L/51CSfk6aT2Hw8QdN9SVDXdBOQJF80SWaFcpLtMIflVdW8vbwBzxBUPHWV jPGpnHz+Kzx2JHg90S84sWlM0V9VRj9Rw3mLZ/iNx9eYNk44J9tk2NP2OGGekflg PpEpZD7i6Cvlxu1vdADEpPnUleib6sQZNRCcIHVwxp2vdFyryLhzABMSnsYPqLJ/ lQIKm7sg+RLo8mn1Eh0YZqKnyKHtkgM9QHsZSh2bpilTr43vw9Ru6dhYf0xdnhb+ vPkohdCHTaTG0DQ1XbjrwFpBVlANWimZ3Qo7xLGveqYGh8PePcE046zTbKcQXxAd hjKRp9xDCs2yk/yvABL2GEFc3FVQNCW6g/kLHE4vipc021Ws/DH7Fc3MWxjjRZuz NnR5M+tw6UyfDK70ZtC65YNwHMB0UkGfJj5ToSX0oruH6H9JWl97XR+tGsXbIBoL +3NRA/rJp48MC+VxDDuGyNvze/iR
  • From Stephan Lachnit@21:1/5 to [email protected] on Thu Feb 10 14:30:01 2022
    On Thu, Feb 10, 2022 at 12:49 PM Holger Levsen <[email protected]> wrote:

    So what do you all think?

    I'm leaning towards explaining the basics in devref (mostly by copying bits from the wiki page) and adding a pointer to the wiki page, but if there's consensus that the wiki page is supposed to be made obsolete by *moving*
    the contents to src:devref and leaving a pointer on the wiki page, I could also do that.

    As already mentioned on IRC, I think in this case I would move the
    information for the DDs to the devref and reference it on the wiki
    with "if you are a DD, see also section X in devref". Currently when I
    search something related to general DD tasks I first look in the
    devref and not in the wiki. In particular most of the DebianMaintainer
    wiki page is for those wanting to become a DM, I only found the
    granting permissions section after looking a second time.

    In general I would put information specific for people who are already
    DDs in the devref written with the assumption that everyone who reads
    it is a DD. The wiki on the other hand is more "public facing", so I
    would put here more introductory content (like "what can I do as a DM"
    and "how I can become a DM").

    Regards,
    Stephan

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Sam Hartman@21:1/5 to All on Thu Feb 10 19:00:02 2022
    "Holger" == Holger Levsen <[email protected]> writes:

    Holger> So what do you all think?

    Holger> I'm leaning towards explaining the basics in devref (mostly
    Holger> by copying bits from the wiki page) and adding a pointer to
    Holger> the wiki page, but if there's consensus that the wiki page
    Holger> is supposed to be made obsolete by *moving* the contents to
    Holger> src:devref and leaving a pointer on the wiki page, I could
    Holger> also do that.

    developers-reference is available offline, is in my experience better organized, and is where I look for stuff like that.
    I am able to place more trust in devref than wiki.debian.org.
    Some parts of wiki.debian.org are great; some parts are horribly out of
    date.

    I'd say that as best we are able, things normal Debian developers need
    to do should be in devref. So, what are DMs, how to grant permissions,
    how to revoke are things I'd hope would be in devref.

    Beyond that, I think wiki.debian.org could be fine.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Gunnar Wolf@21:1/5 to All on Fri Feb 11 07:40:01 2022
    Holger Levsen dijo [Thu, Feb 10, 2022 at 11:49:05AM +0000]:
    hi,

    so Stephan Lachnit submitted an MR for developers-reference on Monday to document how to grant DM upload permissions, which I gladly merged, even though I was aware of "#653399: developers-reference: Please include a paragraph about Debian Maintainers (DM)" still being unresolved.
    (...)
    I'm leaning towards explaining the basics in devref (mostly by copying bits from the wiki page) and adding a pointer to the wiki page, but if there's consensus that the wiki page is supposed to be made obsolete by *moving*
    the contents to src:devref and leaving a pointer on the wiki page, I could also do that.

    I agree with Stephan's and Sam's reasoning, I think the detailed
    information should be in the devref.

    A wiki is by definition open to edition by any (authorized?) user; the
    devref has named editors (as you are very well aware ;-) ) and can be
    seen as verified and curated information. I think the information
    should be concisely explained in the devref, leaving the Wiki for more full/detailed information on specific points, examples, or documenting
    changes as they are discussed or implemented, while waiting for them
    to arrive to the devref's next edition.

    -----BEGIN PGP SIGNATURE-----

    iHUEABYIAB0WIQRgswk9lhCOXLlxQu/i9jtDU/RZiQUCYgYBWgAKCRDi9jtDU/RZ iQU+AP9tp5rrO69YnnEvkrQgi7/Y5GhWkL+9f+dlz1N103ocWAEA6CB9SgVDQMXa DdTZFjvIgO8Ur+PcmP8wOMbsFI8D0ws=
    =Sxd9
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Holger Levsen@21:1/5 to Gunnar Wolf on Fri Feb 11 13:10:01 2022
    On Fri, Feb 11, 2022 at 12:25:36AM -0600, Gunnar Wolf wrote:
    I agree with Stephan's and Sam's reasoning, I think the detailed
    information should be in the devref.

    A wiki is by definition open to edition by any (authorized?) user; the
    devref has named editors (as you are very well aware ;-) ) and can be
    seen as verified and curated information. I think the information
    should be concisely explained in the devref, leaving the Wiki for more full/detailed information on specific points, examples, or documenting changes as they are discussed or implemented,

    Ok, thanks for your feedback, Gunnar, Sam, Stephan & Jochen! I'll take
    this route soon.

    while waiting for them
    to arrive to the devref's next edition.

    fwiw, I've switched the release modell of src:developers-reference to
    'release early, release often', which means I basically aim to release
    directly after each substancial change. By looking at the version number
    in bullseye, which is 11.0.21, you can easily see this ment I did
    21 uploads in the two years of developing bullseye.

    (This poses challenges to translations to say the least, which I plan to address eventually.)

    More help (best in form of patches or commits) absolutly very welcome!
    Any member of the Debian group on salsa can and should commit freely
    & with responsibility :)


    --
    cheers,
    Holger

    ⢀⣴⠾⠻⢶⣦⠀
    ⣾⠁⢠⠒⠀⣿⡁ holger@(debian|reproducible-builds|layer-acht).org
    ⢿⡄⠘⠷⠚⠋⠀ OpenPGP: B8BF54137B09D35CF026FE9D 091AB856069AAA1C
    ⠈⠳⣄

    People call vaccine mandates "Orwellian" even though Orwell died at 46 of tuberculosis, which is now preventable with a vaccine.

    -----BEGIN PGP SIGNATURE-----

    iQIzBAABCgAdFiEEuL9UE3sJ01zwJv6dCRq4VgaaqhwFAmIGT+cACgkQCRq4Vgaa qhyacBAAjVftkyNNjh9/GeLmykn5Zeiygwr3RiaCcI0YezoPvGNQ9SRneFoHYL55 hLVYI+rOW56+fnqcGj+2xZUSUfkKjtSQbzMNfSyE/mn8v26fYw+go9FY60f4EMcR IBe553BOgKeQPNssVDgT9t6kj6qnyh/yksuUvMqt4Uo7fXmw2GluBTS2prg/IHXV NvDdGSrvTOQ7yLBMsBWJLGlaHmjql1Xcvli9YLy3motSGkYDLEWVrwN9RgIvb6YF E3zCUWRFF3ed4lLJNX88SrVAHmzGIhH1algGKSuR5B/jEK+6xjDGOwwnkcjCFpRX 57/j+ekJvlAepf+qfl21awWFCyPdf9eDVKNZrUKtPAgLu9VMshVrwgmuBOBYA8Kn bXcGNcqqLOEwUBTIvnkzhkiikCcXhVXGDpWii8rNMfM1Ah3GBoga47b44juJTbw0 bQkNGT9b28M/bW/uCRyVsckhpuhTW1qtYIZ1wZFJlUhvY/JwUsYJMWi0tqjKjHW+ U9jLRR/oh62j+uCreo74vcMi74mf2svRCU39ctTvoayiyDOyw