I'd like to solicit feedback on what Cargo's documentation should do regarding the
[badges] table in
Cargo.toml. Badges from the manifest are no longer displayed on crates.io (maintainers are encouraged to add badges to their README if they want them displayed). I'm wondering if there is any value in telling users about the
[badges] feature that is mostly not used. Does anyone know of any projects which inspect the badges table?
It might also be useful to separate discussion of the "maintenance" badges from the other badges. There is some ongoing work and open issues about improving the maintenance status on crates.io. There are two parts to this, one is to provide an SVG endpoint to return the maintenance badge. The other is to make the maintenance status part of the database so that maintainers can modify it without publishing a new version. This isn't implemented, but I believe the intent is to use the "maintenance" status from Cargo.toml as the default if the user hasn't set the status in the web interface.
I'd like to propose removing the documentation for all badges except for the
maintenance badge for now. Since crates.io will no longer be paying attention to the other badges, new services will not be added, and old ones will not be updated. The future of
maintenance is still uncertain, but it seems like there is enough interest to keep it around for now. Does this sound like a reasonable course of action for now?
I'd like to keep discussion focused on what to do with documentation today, and not what crates.io should be doing, or how something like the maintenance status should be expressed or updated.