On 8/9/24 09:57, JK Laiho wrote:
Using modern Podman features requires scrounging together information from scattered sources (the docs site, RedHat blogs, this mailing list, Reddit, GitHub issues...) plus the ability to figure out what info is still relevant. It's a sad state of affairs, and from an outsider's perspective, there's no indication of any serious ongoing improvements in this area either. Feature work looks to be proceeding nicely, but without a massive undertaking to consolidate the documentation, update it, and keep it up to date indefinitely, I don't see Podman getting widely adopted. Docker has the mindshare, tons of resources, and their documentation is thorough and up to date. Thank you for sharing this candid feedback, you mention a lot of important points. Based on my experience in open-source in general: This aren't an uncommon set of complaints unfortunately. ISTM like an incentive problem. Maybe we need something like doc-update bounties or improved recognition incentives of some kind.
In any case, I think we can/need to do better in this area. I'll raise this with the team and do what I can to see that it gets more attention. --- Chris Evich (he/him) Senior Quality Assurance Engineer If there's a "hard-way", I'm the first one to implement it.