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.