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)

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)

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)

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)

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)

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)