[Backport 8.17] [DOCS] Edit the Watcher summaries and descriptions (#3345)

[lcawl]

Backport

This will backport the following commits from main to 8.17:

• [DOCS] Edit the Watcher summaries and descriptions (#3345)

Questions ?

Please refer to the Backport tool documentation

[github-actions]

Following you can find the validation results for the APIs you have changed.

API	Status	Request	Response
watcher.ack_watch	🟢	1/1	1/1
watcher.activate_watch	🟢	1/1	1/1
watcher.deactivate_watch	🟢	1/1	1/1
watcher.delete_watch	🟢	2/2	2/2
watcher.execute_watch	🟢	7/7	7/7
watcher.get_watch	🟢	9/9	9/9
watcher.put_watch	🔴	29/38	38/38
watcher.query_watches	⚪	Missing test	Missing test
watcher.start	🟢	1/1	1/1
watcher.stats	🟢	1/1	1/1
watcher.stop	🟢	1/1	1/1

You can validate these APIs yourself by using the make validate target.