4 ms·
Documentation is not great I admit. The problem is that we don't have anyone who is a capable tech writer in the team. It's not something that you can improvise
by bonzini 2y ago
Documentation is not great I admit. The problem is that we don't have anyone who is a capable tech writer in the team. It's not something that you can improvise.
However, all incompatible changes are documented and also announced at least 8 months in advance.
https://www.qemu.org/docs/master/about/removed-features.html https://www.qemu.org/docs/master/about/removed-features.html
https://www.qemu.org/docs/master/about/deprecated.html https://www.qemu.org/docs/master/about/deprecated.html
It may seem like there are many, but in practice they are in very old, mostly unused or very badly designed corners. For example configuration of audio was overhauled last year, and is now the same as basically all other backends (e.g. -audio pa,model=sb16; compare with -nic user,model=e1000 for a network card).
- justinclift 2y agoAs a general thought, would it be possible to put out a "call for tech writers" post or similar on the front of the qemu website, or even a prominent blog post in the blog section?
- bonzini 2y agoYes, I guess it would be an idea. We could also participate to Season of Docs.
- justinclift 2y agoSounds like it'd be a useful avenue for closing a major (non-code) problem with the software. :)
- dev-n 2y agobonzini I'm a QEMU fan ... and a techwriter. Is there a way to send you an email? There's no real contact option on qemu, other than IRC.
- bonzini 2y agopbonzini@redhat.com :) thanks very much!
- guerby 2y agoPaolo Bonzini email is available here: https://github.com/qemu/qemu/blob/master/MAINTAINERS#L134 https://github.com/qemu/qemu/blob/master/MAINTAINERS#L134
- justinclift 2y agoStable url: https://github.com/qemu/qemu/blob/cec99171931ea79215c79661d33423ac84e63b6e/MAINTAINERS#L134 https://github.com/qemu/qemu/blob/cec99171931ea79215c79661d3...