Merge "Create a separate doc for audit watcher"

3 files changed, 19 insertions, 20 deletions

diff --git a/doc/source/audit_watchers.rst b/doc/source/audit_watchers.rst
new file mode 100644
index 000000000..51ca39537
--- /dev/null
+++ b/doc/source/audit_watchers.rst
@@ -0,0 +1,12 @@
+.. _common_audit_watchers:
+
+*********************
+Object Audit Watchers
+*********************
+
+.. _dark_data:
+
+Dark Data
+=========
+
+.. automodule:: swift.obj.watchers.dark_data
diff --git a/doc/source/development_watchers.rst b/doc/source/development_watchers.rst
index 48e9310b1..6aee25439 100644
--- a/doc/source/development_watchers.rst
+++ b/doc/source/development_watchers.rst
@@ -104,23 +104,9 @@ Dark Data Watcher
 
 The watcher API is assumed to be under development. Operators who
 need extensions are welcome to report any needs for more arguments
-to see_object(). For now, start by copying the provided template watcher
-swift/obj/watchers/dark_data.py and see if it is sufficient.
-
-The name of "Dark Data" refers to the scientific hypothesis of Dark Matter,
-which supposes that the universe contains a lot of matter than we cannot
-observe. The Dark Data in Swift is the name of objects that are not
-accounted in the containers.
-
-The experience of running large scale clusters suggests that Swift does
-not have any particular bugs that trigger creation of dark data. So,
-this is an excercise in writing watchers, with a plausible function.
-
-When enabled, Dark Data watcher definitely drags down the cluster's overall
-performance, as mentioned above. Of course, the load increase can be
-mitigated as usual, but at the expense of the total time taken by
-the pass of auditor.
-
-Finally, keep in mind that Dark Data watcher needs the container
-ring to operate, but runs on an object node. This can come up if
-cluster has nodes separated by function.
+to see_object().
+
+The :ref:`dark_data` watcher has been provided as an example. If an
+operator wants to create their own watcher, start by copying
+the provided example template ``swift/obj/watchers/dark_data.py`` and see
+if it is sufficient.
diff --git a/doc/source/index.rst b/doc/source/index.rst
index f9f23e464..f1b6bee6f 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -166,6 +166,7 @@ Source Documentation
     object
     misc
     middleware
+    audit_watchers
 
 
 Indices and tables