doc: update user docs and release notes

Fixes: https://tracker.ceph.com/issues/71495

Signed-off-by: Shraddha Agrawal <[email protected]>

Author: shraddhaag

PendingReleaseNotes

@@ -147,12 +147,14 @@
   `s3:GetObjectRetention` are also considered when fetching the source object.
   Replication of tags is controlled by the `s3:GetObject(Version)Tagging` permission.
 
-* RADOS: A new command, `ceph osd pool availability-status`, has been added that allows
+* RADOS: A new command, ``ceph osd pool availability-status``, has been added that allows
   users to view the availability score for each pool in a cluster. A pool is considered 
   unavailable if any PG in the pool is not in active state or if there are unfound 
   objects. Otherwise the pool is considered available. The score is updated every 
-  5 seconds. The feature is on by default. A new config option `enable_availability_tracking`
-  can be used to turn off the feature if required. This feature is in tech preview. 
+  5 seconds. The feature is on by default. A new config option ``enable_availability_tracking``
+  can be used to turn off the feature if required. Another command is added to clear the 
+  availability status for a specific pool, ``ceph osd pool clear-availability-status <pool-name>``. 
+  This feature is in tech preview. 
   Related trackers:
    - https://tracker.ceph.com/issues/67777
 

doc/rados/operations/monitoring.rst

@@ -794,4 +794,13 @@ downtime, the ``enable_availability_tracking`` config option can be set to ``fal
    ceph config set mon enable_availability_tracking false
 
 While the feature is turned off, the last calculated score will be preserved. The 
-score will again start updating once the feature is turned on again. 
+score will again start updating once the feature is turned on again. 
+
+It's also possible to clear the data availability score for a specific 
+pool if needed with a command of the following form:
+
+.. prompt:: bash $
+
+   ceph osd pool clear-availability-status <pool-name>
+
+Note: Clearing a score is not allowed if the feature itself is disabled.