On 31/08/2024 14:07, Thomas Schmitt wrote:
https://wiki.debian.org/XorrisoDdTarget

Disclaimer: I prefer non-destructive way of making bootable media. For UEFI it is just copying files, for BIOS it requires some commands like syslinux and editing of grub configuration. Perhaps I just have not faced cases when it is not enough. That is why I do not expect that I will become a regular user of xorriso-dd-target.

If you prefer to keep the wiki page isolated, it is up to you. More people may discover it if e.g. CategoryDebianInstaller is added. Perhaps there is a better category.

On 02/09/2024 13:30, Thomas Schmitt wrote:
Thomas, are you intentionally linking raw man page instead of a
formatted > one [[DebianMan:xorriso-dd-target|xorriso-dd-target(1)]]?

Once it was intentional, when the package was only in Debian Testing
and no Debian online man page existed.

<http://manpages.debian.org/testing/xorriso-dd-target>
[[DebianMan:testing/xorriso-dd-target]]

where can learn about the style of a "Debian official" block or a
"See also" section ?

<https://wiki.debian.org/DebianWiki/EditorGuide#Debian_.22official_material.22_banner>

My point is that the purpose of your script is to enhance the recipe given in
<https://www.debian.org/releases/bookworm/amd64/ch04s03.en.html>
so this link is suitable to give more context

In my opinion, when a user asks a question similar to the one started this thread then a link to "Debian GNU/Linux Installation Guide" should be first answer. This time the XorrisoDdTarget wiki page was posted earlier, so a link to the installation guide will increase a chance to make users aware of this document.

On 02/09/2024 15:07, Thomas Schmitt wrote:
Max Nikulin wrote:
Is there a reason why the page is not cross-linked with
<https://wiki.debian.org/DebianInstaller/CreateUSBMedia>?
[...]
But i have few idea how i should motivate a link from XorrisoDdTarget,

My opinion is that simple "See also" section at the end is enough for curious users to discover alternatives. I do not consider CreateUSBMedia as a perfect article, but it has some value. More users notice it means more chances that it will be improved.

On 02/09/2024 18:01, Thomas Schmitt wrote:

i added a new section
   https://wiki.debian.org/XorrisoDdTarget#How_to_verify_the_result
instead of a mere link because i deem the Debian instructions too
scattered for being suitable for already puzzled and stressed users.

Notice that you have a mention of .sig files in the beginning.

Step by step instruction how to verify a downloaded image is valuable. Some time ago I was surprised that there is no one in Debian manual and wiki. However it does not specific to xorriso-dd-target, I would consider moving content to another article.

Another part is mostly troubleshooting for the case of firmware writing to EFI/. I can not imagine a case when it may provide something useful if actual issue is namely writing to a USB block device. Is there an article on debugging of installer images?

I do not insist on any changes. If you do not like linking to the pages I asked about, just ignore it.

Reply via email to