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
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 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.
Hi,Most of the Debian packaging docs assume at least basic knowledge about
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.
Suggested solution:I'm not sure if it makes sense to cross-link basic stuff on all wiki
Create or locate the dsc-file definition in the wiki.
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.
Sysop: | Keyop |
---|---|
Location: | Huddersfield, West Yorkshire, UK |
Users: | 349 |
Nodes: | 16 (2 / 14) |
Uptime: | 107:37:05 |
Calls: | 7,612 |
Calls today: | 3 |
Files: | 12,786 |
Messages: | 5,683,001 |
Posted today: | 2 |