xbps virtualpkg documentation
Currently it uses virtualpkg=linux:linux5.6 as example which has some weird side effects, ignorepkg is more appropriate in this case.
A good alternative would be to actually use a real virtual package like awk or similar to show how switch between the "default" provider and another installed provider.
https://github.com/void-linux/void-docs/blob/d2e9ebaebabd2ef5cfd2bb254900cf9506aeb2c4/src/xbps/advanced-usage.md#virtual-packages
Maybe the example in void-docs and those in xbps.d.5 and xbps.conf could be kept in sync. The latter currently use virtualpkg=cron-daemon:dcron as example.
This is another issue gravitating around xbps/advanced-usage.md. And it shows the connection to man pages. There is some overlap, but of course man pages are technical (written rather by devs), and the user docs rather have use cases and are helpful for beginners. "keep in sync" by harmonizing, not duplicating.
And thank you for the link to the github md file. I was wondering all the time how to present a change once I start.