diff --git a/lib/ldclient-openfeature/provider.rb b/lib/ldclient-openfeature/provider.rb
index c924f92..f339d43 100644
--- a/lib/ldclient-openfeature/provider.rb
+++ b/lib/ldclient-openfeature/provider.rb
@@ -6,10 +6,19 @@
 module LaunchDarkly
   module OpenFeature
     class Provider
+      #
+      # Retrieve metadata information describing this provider.
+      #
+      # @return [::OpenFeature::SDK::Provider::ProviderMetadata]
+      #
       attr_reader :metadata
 
       #
-      # @return client [LaunchDarkly::LDClient]
+      # Access the underlying LaunchDarky client instance backing this provider.
+      #
+      # This is useful for accessing additional functionality not exposed by the provider.
+      #
+      # @return [LaunchDarkly::LDClient]
       #
       attr_reader :client