Docs on client interfaces

Author: WyriHaximus

src/AsyncClientInterface.php

@@ -11,8 +11,20 @@
 
 interface AsyncClientInterface
 {
+    /**
+     * Take a string create by the extract method and hydrate it back to a resource.
+     *
+     * @param string $resource
+     * @return CancellablePromiseInterface
+     */
     public function hydrate(string $resource): CancellablePromiseInterface;
 
+    /**
+     * Extract a resource into a string for storage.
+     *
+     * @param ResourceInterface $resource
+     * @return CancellablePromiseInterface
+     */
     public function extract(ResourceInterface $resource): CancellablePromiseInterface;
 
     /**

src/ClientInterface.php

@@ -10,8 +10,20 @@
 
 interface ClientInterface
 {
+    /**
+     * Take a string create by the extract method and hydrate it back to a resource.
+     *
+     * @param string $resource
+     * @return ResourceInterface
+     */
     public function hydrate(string $resource): ResourceInterface;
 
+    /**
+     * Extract a resource into a string for storage.
+     *
+     * @param ResourceInterface $resource
+     * @return string
+     */
     public function extract(ResourceInterface $resource): string;
 
     /**