1. Forum
  2. Usenet
  3. LINUX.DEBIAN.MAINT.PYTHON

  • Feature Request (docu): Define "dsc-file"

    From c.buhtz@posteo.jp@21:1/5 to All on Fri Mar 15 08:50:01 2024
    Hi,

    this is a feature request to someone who has access and the knowledge to improve.

    Description of the problem:

    The second paragraph in <https://wiki.debian.org/Python/GitPackaging#Creating_a_new_package>
    tell me about importing a "dsc-file" without explaining what a dsc-file
    is or why I have to import it. The knowledge background is missing.

    There is a hyper link behind the text "import an existing .dsc file"
    pointing to <https://wiki.debian.org/PackagingWithGit/GitDpm/ImportDsc>. Regarding that URL I assume this wiki entry is not maintained by DPT.
    But it also do not explain about dsc-file.

    Suggested solution:
    Create or locate the dsc-file definition in the wiki. It should be an
    extra page. Then just use a hyperlink in your own docu to point to that definition.

    "import an existing .dsc file"
    ^^^^^^ ^^^^^^^^^
    I L <https://wiki.debian.org/DSC-DEFINITION>
    L <https://wiki.debian.org/PackagingWithGit/GitDpm/ImportDsc>

    Please let me know if there is another "channel" where I should open
    such requests.

    Thanks in advance
    Christian Buhtz

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Andreas Tille@21:1/5 to All on Fri Mar 15 11:10:02 2024
    Hi

    Am Fri, Mar 15, 2024 at 07:39:39AM +0000 schrieb c.buhtz@posteo.jp:
    Hi,

    this is a feature request to someone who has access and the knowledge to improve.

    Description of the problem:

    The second paragraph in <https://wiki.debian.org/Python/GitPackaging#Creating_a_new_package> tell me about importing a "dsc-file" without explaining what a dsc-file is or why I have to import it. The knowledge background is missing.

    Please try a web search for instance with the terms

    debian source format dsc file

    which brought several helpful links. Alternatively you can ask ChatGPT,
    Gemini or the LLM of your choice

    Can you explain what "import an existing .dsc file" means?

    which produced a very verbose and good understandable text for me.

    I do not think that things which are easy to find and is pretty clear
    for the average reader of the text you want to extend should be written
    down here.

    Thank you for your suggestion anyway
    Andreas.


    There is a hyper link behind the text "import an existing .dsc file"
    pointing to <https://wiki.debian.org/PackagingWithGit/GitDpm/ImportDsc>. Regarding that URL I assume this wiki entry is not maintained by DPT. But it also do not explain about dsc-file.

    Suggested solution:
    Create or locate the dsc-file definition in the wiki. It should be an extra page. Then just use a hyperlink in your own docu to point to that
    definition.

    "import an existing .dsc file"
    ^^^^^^ ^^^^^^^^^
    I L <https://wiki.debian.org/DSC-DEFINITION>
    L <https://wiki.debian.org/PackagingWithGit/GitDpm/ImportDsc>

    Please let me know if there is another "channel" where I should open such requests.

    Thanks in advance
    Christian Buhtz



    --
    http://fam-tille.de

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From c.buhtz@posteo.jp@21:1/5 to All on Fri Mar 15 12:10:01 2024
    Thanks for all your answers.

    Am 15.03.2024 11:07 schrieb Andreas Tille:
    Please try a web search for instance with the terms
    [...]
    which brought several helpful links. Alternatively you can ask
    ChatGPT,
    Gemini or the LLM of your choice

    I am a bit shocked about that advise. For what was Hypertext invented?

    My mail was not a support question but a Feature Request. Of course I am
    able to search this myself. But this won't help future readers and also
    won't improve the quality of the docs. The latter is my intention.

    Basic knowledge is needed to understand? Of course this is always the
    case in every section of live and the world.
    But why not point to that knowledge? That is what Hypertext is invented
    for.

    I do not think that things which are easy to find

    No it is not "easy" when I have to run search engine for it. It is also
    not sustainable.

    and is pretty clear
    for the average reader of the text you want to extend should be written
    down here.

    I don't understand that section.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Andrey Rakhmatullin@21:1/5 to c.buhtz@posteo.jp on Fri Mar 15 11:40:01 2024
    On Fri, Mar 15, 2024 at 07:39:39AM +0000, c.buhtz@posteo.jp wrote:
    Hi,

    this is a feature request to someone who has access and the knowledge to improve.

    Description of the problem:

    The second paragraph in <https://wiki.debian.org/Python/GitPackaging#Creating_a_new_package> tell me about importing a "dsc-file" without explaining what a dsc-file is or why I have to import it. The knowledge background is missing.
    Most of the Debian packaging docs assume at least basic knowledge about
    Debian source and binary packages.

    Suggested solution:
    Create or locate the dsc-file definition in the wiki.
    I'm not sure if it makes sense to cross-link basic stuff on all wiki
    pages, to be honest. But that's
    https://wiki.debian.org/Packaging/SourcePackage


    --
    WBR, wRAR

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

    iQJhBAABCgBLFiEEolIP6gqGcKZh3YxVM2L3AxpJkuEFAmX0HFEtFIAAAAAAFQAP cGthLWFkZHJlc3NAZ251cGcub3Jnd3JhckBkZWJpYW4ub3JnAAoJEDNi9wMaSZLh jycQAILJMTidr0duz9xcv9qybFK2JTIm1oLwukhw4SEQNbC7Ty+fx+/I588jen3k HfF8+k9QAC0bvzvKy/kdikP0HwEZWrtj0x3T15Y7BDTrWCVeK1IGAIyzfsDxaR3T Z7FC+GMila/wykZck3XA5LSaGM/WNvmdfAifSZ4rTft44orHOB0Wui4Ve1WQ/qCq 9c2I1BSdD2quGLVFm39dprJdx/uTO51n3jemIKgEORqvi7ynRQ9HsdEx+o7SoEz0 FCjhINOhVrqn//XcIf3A1xzrjGqD86xRmc/pwNsLnb09LkQqz1Qe/ms/QuVRp3lQ 0NJZMGcEPlFNt5KoaxxF4KOKGLPemA4OigkPTdeEYBMxnTS9rKawYtalGZfIq+az sdjcFblKR9CxyzYfS/OEp4E1N8bjUokZNxEFmPH7Z0+z4UNt8QojamiDvQoiPD7j jZvJCrfSEmZGBj7LrgqLv0tkQK/YnR2FdclRbVEF59S3PU/beGYuJgWEluvDXtKQ z7WbMkPuJ7yDMgOmo1WQd5WxAYZnrg0mtcuE6Au5rsm5VMVCWrjZZvs8tbNWs33d yV8ZxSI+CvCoAoDmO4dRDYdqGVA4rp6B+1xw2hnkOWx+BFzb2LCHo84Jo2mbgSW6 aQKJfPeZfgo7o2C9/IlsT5pOpAyhkKJmL8GYZn33S5QhgLEs
    =mS/r
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From c.buhtz@posteo.jp@21:1/5 to All on Fri Mar 15 12:20:01 2024
    Close via https://wiki.debian.org/Python/GitPackaging?action=diff&rev1=97&rev2=98

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Andreas Tille@21:1/5 to All on Fri Mar 15 13:40:01 2024
    Hi again,

    Am Fri, Mar 15, 2024 at 11:06:13AM +0000 schrieb c.buhtz@posteo.jp:
    Thanks for all your answers.

    Am 15.03.2024 11:07 schrieb Andreas Tille:
    Please try a web search for instance with the terms
    [...]
    which brought several helpful links. Alternatively you can ask ChatGPT, Gemini or the LLM of your choice

    I am a bit shocked about that advise. For what was Hypertext invented?

    Sorry if I might have been a bit blunt. I admit you Wiki changes are OK.

    My mail was not a support question but a Feature Request. Of course I am
    able to search this myself. But this won't help future readers and also
    won't improve the quality of the docs. The latter is my intention.

    I'm fine if someone wants to improve the docs.

    Basic knowledge is needed to understand? Of course this is always the case
    in every section of live and the world.
    But why not point to that knowledge? That is what Hypertext is invented for.

    I do not think that things which are easy to find

    No it is not "easy" when I have to run search engine for it. It is also not sustainable.

    Well, I'm usually a fan of letting newcomers enhance the docs since
    experts might fail to see beginners hurdles. I admit I was afraid that
    the request would end up explaining very basic packaging stuff at places
    where the topic is specific about using Git for the Python team.

    and is pretty clear
    for the average reader of the text you want to extend should be written down here.

    I don't understand that section.

    I mean that the topic of that page is "Using git for team packages" and
    we should not blur that topic with information which is very basic for
    the intended user audience. Adding a hyperlink as you did is OK.
    Explaining .dsc format is over the top IMHO.

    To make sure you will not misunderstand me: I did not wanted to scare
    away a newcomer by redirecting to other resources of information. I
    hope that my hints where helpful enough for you to know now what .dsc
    is.

    Kind regards
    Andreas.

    --
    http://fam-tille.de

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)