On Wed, 19 Feb 2025 at 14:54:41 +0000, Ian Jackson wrote: > I'd like to encourage you to find *somewhere* to put it that's not > just this bug report. Maybe a file in /usr/share/doc, as part of the > podman package?
I wrote this with a specific audience in mind, namely you and Sean (git experts with a lot of schroot experience), and I don't think it's general-purpose documentation. To a reader who does not have your git expertise, the analogy to git would likely be more confusing than helpful, and to a reader outside the Debian bubble, analogies to schroot are also not going to be helpful. Sorry, but I don't feel that what I wrote is in a useful form to be in the podman package, and I would not feel comfortable asking the podman maintainers to include it: adding some text describing one specific use-case to the podman package is helpful right now for anyone who has that exact use-case, but it is unlikely to be particularly discoverable, will not be kept updated over time if things change, and doesn't help podman users whose use-case is different. A general-purpose tutorial on what is meant by images, container instances, repositories and tags almost certainly already exists in the podman documentation, and there are probably literally hundreds on the internet (the concepts and terminology are the same as in the widely-used Docker suite, and I'm only preferring Podman for autopkgtest purposes because Docker requires a daemon and normally requires making its user be root-equivalent). Some sort of documentation about routine maintenance for a Docker/Podman host system is probably also something that already exists, but I don't know where specifically to look for it; and if it doesn't already exist in the podman package, perhaps it should (ideally in the upstream podman project rather than being Debian-specific). Sorry, I'm not willing to volunteer to convert my stream-of-consciousness into formal documentation that meets the podman maintainers' standards: the list of things in Debian and open source that I'm required to feel guilty for not having done is already considerably longer than my ability to clear it. If you feel that I am wrong about this, anyone else is welcome to submit a suitably edited version of that text to the podman maintainers, but only if they make themselves and not me responsible for its content and correctness. (Please consider what I wrote in https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1098352#15 to be licensed under CC0 or FSFAP, your choice.) smcv
