I am going to have to do a breaking change on a plugin soon and I am playing around with what the best way of informing my users would be.
I think it would be really neat if as part of the versions document it was possible to add additional information:
{
"0.5.0": {
"obsidianMinVersion": "0.13.16",
"breaking": true,
"breakingUrl": "https://jeppe.science/thoughts/breaking_change"
},
"0.4.1": "0.13.16",
"0.4.0": "0.13.16",
"0.3.0": "0.13.16",
"0.2.23": "0.13.16",
}
This would be presented to the user in the following way:
- Does not get updated using
update all
- A button next to
update
takes you to thebreakingUrl
so you can read up on how to best go forward - Pressing
update
presents a modal that the user must press “ok, I understand that this is a breaking change” - Row with plugin is highlighted to make it stand out visually (since
update all
no longer updates this, it will be handy to have it highlighted)