diff --git a/docs/extras/integrations/text_embedding/sagemaker-endpoint.ipynb b/docs/extras/integrations/text_embedding/sagemaker-endpoint.ipynb
index 96d09be4b16..fe5299ae6f2 100644
--- a/docs/extras/integrations/text_embedding/sagemaker-endpoint.ipynb
+++ b/docs/extras/integrations/text_embedding/sagemaker-endpoint.ipynb
@@ -48,10 +48,31 @@
     "    accepts = \"application/json\"\n",
     "\n",
     "    def transform_input(self, inputs: list[str], model_kwargs: Dict) -> bytes:\n",
-    "        input_str = json.dumps({\"inputs\": inputs, **model_kwargs})\n",
+    "        \"\"\"\n",
+    "        Transforms the input into bytes that can be consumed by SageMaker endpoint.\n",
+    "        Args:\n",
+    "            inputs: List of input strings.\n",
+    "            model_kwargs: Additional keyword arguments to be passed to the endpoint.\n",
+    "        Returns:\n",
+    "            The transformed bytes input.\n",
+    "        \"\"\"\n",
+    "        # Example: inference.py expects a JSON string with a \"inputs\" key:\n",
+    "        input_str = json.dumps({\"inputs\": inputs, **model_kwargs})  \n",
     "        return input_str.encode(\"utf-8\")\n",
     "\n",
     "    def transform_output(self, output: bytes) -> List[List[float]]:\n",
+    "        \"\"\"\n",
+    "        Transforms the bytes output from the endpoint into a list of embeddings.\n",
+    "        Args:\n",
+    "            output: The bytes output from SageMaker endpoint.\n",
+    "        Returns:\n",
+    "            The transformed output - list of embeddings\n",
+    "        Note:\n",
+    "            The length of the outer list is the number of input strings.\n",
+    "            The length of the inner lists is the embedding dimension.\n",
+    "        \"\"\"\n",
+    "        # Example: inference.py returns a JSON string with the list of\n",
+    "        # embeddings in a \"vectors\" key:\n",
     "        response_json = json.loads(output.read().decode(\"utf-8\"))\n",
     "        return response_json[\"vectors\"]\n",
     "\n",
@@ -60,7 +81,6 @@
     "\n",
     "\n",
     "embeddings = SagemakerEndpointEmbeddings(\n",
-    "    # endpoint_name=\"endpoint-name\",\n",
     "    # credentials_profile_name=\"credentials-profile-name\",\n",
     "    endpoint_name=\"huggingface-pytorch-inference-2023-03-21-16-14-03-834\",\n",
     "    region_name=\"us-east-1\",\n",
diff --git a/libs/experimental/README.md b/libs/experimental/README.md
index c65686df78c..adf8a06422c 100644
--- a/libs/experimental/README.md
+++ b/libs/experimental/README.md
@@ -1,3 +1,16 @@
 # 🦜️🧪 LangChain Experimental
 
-This repository holds more experimental LangChain code.
\ No newline at end of file
+This package holds experimental LangChain code, intended for research and experimental
+uses.
+
+> [!WARNING]
+> Portions of the code in this package may be dangerous if not properly deployed
+> in a sandboxed environment. Please be wary of deploying experimental code
+> to production unless you've taken appropriate precautions and
+> have already discussed it with your security team.
+
+Some of the code here may be marked with security notices. However,
+given the exploratory and experimental nature of the code in this package,
+the lack of a security notice on a piece of code does not mean that
+the code in question does not require additional security considerations
+in order to be safe to use.