Adding documentation for secret watches (#541)

* Adding documentation for secret watches

* Adding feedback

* Adding quotes to tags

Author: savitharaghunathan

docs/design/watches.md

@@ -0,0 +1,14 @@
+# Watching Secrets
+
+The provider secret gets created independently by the user, and it is not part of the operator lifecyle itself. In order for the operator to update the current state of its operands in the case where the provider secrets get deleted or updated, the secret object needs to be watched as a part of the reconcile loop. To achieve this, the secrets are labeled with the following:
+
+```
+ 1. oadpApi.OadpOperatorLabel: "True"
+ 2. <namespace>.dataprotectionapplication: <name>
+```
+
+where `<namespace>` is the namespace where OADP operator is installed and `<name>` is the name of the DPA instance
+
+# Current State
+
+When the labeled secret objects get deleted, the operator status gets updated accordingly. Once that happens, if a new secret gets created in the place of original secret, it does not get labeled as of now. There are plans in the future to automatically label the incoming secrets and add it to the reconcile loop. For now, in order to trigger the DPA CR status update, we suggest recreating the operator pod.