chore: update topics and leaderboards response object pages (#1161)

docs/leaderboards/api-reference/response-objects.md

@@ -17,29 +17,27 @@ Errors that occur in calls to the Momento Leaderboards service are surfaced to d
 
 ### Available methods
 
-- message(): String - a human readable error message
-- innerException(): Exception - the original exception.
-- errorCode(): MomentoErrorCode - Momento’s own category of errors such as InvalidArgument or BadRequest. See [Standards And Practices - Error Handling](https://github.com/momentohq/standards-and-practices/blob/main/docs/client-specifications/error-handling.md)
-- toString(): String - alias for message()
+- `message()`: String - a human readable error message
+- `innerException()`: Exception - the original exception.
+- `errorCode()`: MomentoErrorCode - Momento’s own category of errors such as InvalidArgument or BadRequest. See [Standards And Practices - Error Handling](https://github.com/momentohq/standards-and-practices/blob/main/docs/client-specifications/error-handling.md)
+- `toString()`: String - alias for message()
 
 ---
 
 ## Success
 
-Generic response object indicating a successful request with no additional methods attached. Variations of the Success response object include:
+Generic response object indicating a successful request with no additional methods attached. 
 
-### LeaderboardFetch
+Variations of the Success response object include:
 
-Indicates a successful fetch request.
+### LeaderboardFetch
 
-#### Available methods
+Indicates a successful fetch request. Available methods include:
 
-- values(): List - returns a list of records containing the fields `id`, `score`, and `rank`
+- `values()`: List - returns a list of records containing the fields `id`, `score`, and `rank`
 
 ### LeaderboardLength
 
-Indicates a successful length request.
-
-#### Available methods
+Indicates a successful length request. Available methods include: 
 
-- length(): Integer - returns the number of elements in the specified leaderboard
+- `length()`: Integer - returns the number of elements in the specified leaderboard

docs/topics/develop/api-reference/response-objects.md

@@ -7,51 +7,61 @@ description: Learn how to interact with the response object in the Momento API f
 
 # Response objects from Momento APIs in Momento Topics
 
-These are the baseline responses for all commands. Some commands will add more data and functionality.
+Momento response objects extend from a parent class, have child types such as `Success` and `Error,` and are designed to be accessed via pattern matching. (In some languages, this concept is called "sealed classes"; in others, "algebraic data types". It is a flavor of polymorphism.) Your code checks whether the response is a `Success` or an `Error`, and then branches accordingly. Using this approach, you get a type-safe response object that you can use to get more information.
 
-Commands fall *generally* into two categories. Those which respond with: 
-1. **Success or Error** - An example is a Set operation. Either the item was successfully written to the cache or it errored.
-2. **Hit, Miss, or Error** - An example is a Get operation. If the requested item is in the cache, you have a cache Hit. If it is not in the cache, you get a cache Miss. If there is some sort of error, you get an Error.
+---
 
 ## Error
 
-Returned in lieu of an exception.
-
-### Constructor
+Errors that occur in calls to the Momento Leaderboards service are surfaced to developers as part of the return values of the calls rather than thrown exceptions. This helps to ensure your application doesn't crash at runtime, makes errors more visible when you're writing your code, and allows your IDE to be more helpful in ensuring you've handled the errors you care about. For more on our philosophy about this, see our blog post on why [Exceptions are bugs](https://www.gomomento.com/blog/exceptions-are-bugs), and send us any feedback you have!
 
-- innerException: Exception - the exception which caused the error
+### Available methods
 
-### Methods
+- `message()`: String - a human readable error message
+- `innerException()`: Exception - the original exception.
+- `errorCode()`: MomentoErrorCode - Momento’s own category of errors such as InvalidArgument or BadRequest. See [Standards And Practices - Error Handling](https://github.com/momentohq/standards-and-practices/blob/main/docs/client-specifications/error-handling.md)
+- `toString()`: String - alias for message()
 
-- message(): String - a human readable error message
-- innerException(): Exception - the original exception.
-- errorCode(): MomentoErrorCode - Momento’s own category of errors such as InvalidArgument or BadRequest. See [Standards And Practices - Error Handling](https://github.com/momentohq/standards-and-practices/blob/main/docs/client-specifications/error-handling.md)
-- toString(): String - alias for message()
+---
 
 ## Success
 
-The command was successful.
+Generic response object indicating a successful request with no additional methods attached. 
+
+Variations of the Success response object include:
+
+### Subscription
+
+Indicates a successful Momento Topics subscription. Depending on the language, you may be provided a callback function or an iterator you can use to poll for new subscription items.
+
+Available methods include:
+
+- `unsubscribe()`: void - closes the topics subscription.
 
-## Hit
+### ListWebhooks
 
-The key or field exists in the cache. Usually extended to return a value.
+Indicates a successful list webhooks request. Available methods include: 
 
-## Miss
+- `getWebhooks()`: List - returns a list of existing webhooks. Each [`Webhook` object](./webhooks#webhook-object) contains the fields `destination`, `id`, and `topicName`.
 
-The key or field does not exist in the cache.
+### PutWebhook
 
-## Set
+Indicates a successful put webhook request. Available methods include: 
 
-For TTL commands, the update was applied successfully.
+- `secretString()`: String - returns the signing secret for the webhook.
 
-## NotSet
+### GetWebhookSecret
 
-For TTL commands, the update was not applied and no change was made to the existing TTL.
+Indicates a successful get webhook secret request. Available methods include: 
 
-## Stored
+- `secret()`: String - returns the signing secret for the webhook.
+- `webhookName()`: String - returns the name of the webhook.
+- `cacheName()`: String - returns the name of the cache associated with the webhook.
 
-For setIf* commands, the key did not exist and the value was set.
+### RotateWebhookSecret
 
-## NotStored
+Indicates a successful rotate webhook secret request. Available methods include: 
 
-For setIf* commands, the key existed and no value was set.
+- `secret()`: String - returns the signing secret for the webhook.
+- `webhookName()`: String - returns the name of the webhook.
+- `cacheName()`: String - returns the name of the cache associated with the webhook.