The Problem
I am building an application that relies on other uses getting watching notifications for it to be as successful as possible.
I would like to avoid explaining the exact use case until I've made an announcement about the app, but essentially if people aren't sent watching notifications it would make this application almost useless.
Implemention example - each method call
Perhaps there could be an additional parameter in the page.save_one method which asks whether notifications should be sent to watchers? By default, it would be disabled / turned off.
Implementation example - Site manager
Personally, I'd also like to receive notifications for every change made on the wikis I am master administrator of, even if it's done by API. I don't care if it's thousands of emails some times. So perhaps this could be enabled on a site-wide basis through the site manager.
Send watching notifications for API modifications?
[_] Yes, to admins and moderators only
[_] Yes, to all watchers
[_] No (default)
Then, I could just ask users of the application to change this setting in their site manager before they use it.
Retrieving watching status
Perhaps another method would also be useful, which returns information about whether watching notifications will be sent or not for the specified site. (e.g. returns which box is ticked in site manager).
Then I could ask the user to enable the notifications if, and only if, it's not already enabled.
Shane Smith
ethicalwd.com - Blog - Wikidot Editor - Docs