What is stated in the docs is that you have to restart openhab. What isn’t stated is that you should stop openhab before editing the files, that’s my experience anyway. I edited the files as per the documentation, restarted openhab and it had rewritten the files, presumably on shutdown. So it seems to be “stop, edit, start”, rather than “edit, restart”.
That’s all.