docs(community): update docstrings for reference docs #1237

libs/community/langchain_google_community/bigquery.py

@@ -20,13 +20,17 @@ def import_bigquery() -> Any:
 
 
 class BigQueryLoader(BaseLoader):
-    """Load from the Google Cloud Platform `BigQuery`.
+    """Load documents from Google Cloud BigQuery.
 
-    Each document represents one row of the result. The `page_content_columns`
-    are written into the `page_content` of the document. The `metadata_columns`
-    are written into the `metadata` of the document. By default, all columns
-    are written into the `page_content` and none into the `metadata`.
+    Inherits from [`BaseLoader`][langchain_core.document_loaders.BaseLoader].
+    Each row becomes a document. Columns can be mapped to `page_content` or
+    `metadata`. By default, all columns map to `page_content`.
 
+    !!! note "Installation"
+        Requires additional dependencies:
+        ```bash
+        pip install langchain-google-community[bigquery]
+        ```
     """
 
     def __init__(
@@ -48,8 +52,8 @@ def __init__(
                 document.
             credentials: Optional. Credentials for accessing Google APIs. Use this
                 parameter to override default credentials, such as to use Compute Engine
-                (``google.auth.compute_engine.Credentials``) or Service Account
-                (``google.oauth2.service_account.Credentials``) credentials directly.
+                (`google.auth.compute_engine.Credentials`) or Service Account
+                (`google.oauth2.service_account.Credentials`) credentials directly.
         """
         import_bigquery()
         self.query = query

libs/community/langchain_google_community/calendar/create_event.py

@@ -14,7 +14,7 @@
 
 
 class CreateEventSchema(BaseModel):
-    """Input for CalendarCreateEvent."""
+    """Input schema for `CalendarCreateEvent`."""
 
     summary: str = Field(..., description="The title of the event.")
     start_datetime: str = Field(

libs/community/langchain_google_community/calendar/current_datetime.py

@@ -11,7 +11,7 @@
 
 
 class CurrentDatetimeSchema(BaseModel):
-    """Input for GetCurrentDatetime."""
+    """Input schema for `GetCurrentDatetime`."""
 
     calendar_id: Optional[str] = Field(
         default="primary", description="The calendar ID. Defaults to 'primary'."

libs/community/langchain_google_community/calendar/delete_event.py

@@ -9,7 +9,7 @@
 
 
 class DeleteEventSchema(BaseModel):
-    """Input for CalendarDeleteEvent."""
+    """Input schema for `CalendarDeleteEvent`."""
 
     event_id: str = Field(..., description="The event ID to delete.")
     calendar_id: Optional[str] = Field(

libs/community/langchain_google_community/calendar/move_event.py

@@ -9,7 +9,7 @@
 
 
 class MoveEventSchema(BaseModel):
-    """Input for CalendarMoveEvent."""
+    """Input schema for `CalendarMoveEvent`."""
 
     event_id: str = Field(..., description="The event ID to move.")
     origin_calendar_id: str = Field(..., description="The origin calendar ID.")

libs/community/langchain_google_community/calendar/search_events.py

@@ -12,7 +12,7 @@
 
 
 class SearchEventsSchema(BaseModel):
-    """Input for CalendarSearchEvents."""
+    """Input schema for `CalendarSearchEvents`."""
 
     calendars_info: str = Field(
         ...,

libs/community/langchain_google_community/calendar/toolkit.py

@@ -32,16 +32,20 @@
 class CalendarToolkit(BaseToolkit):
     """Toolkit for interacting with Google Calendar.
 
-    *Security Note*: This toolkit contains tools that can read and modify
-        the state of a service; e.g., by reading, creating, updating, deleting
-        data associated with this service.
+    Provides tools for calendar operations including creating, searching,
+    updating, moving, and deleting events.
 
-        For example, this toolkit can be used to create events on behalf of the
-        associated account.
+    !!! warning "Security"
+        This toolkit contains tools that can read and modify the state of a
+        service. For example, it can create, update, and delete calendar events
+        on behalf of the associated account.
 
-        See https://python.langchain.com/docs/security for more information.
+        See [Security Best Practices](https://python.langchain.com/docs/security)
+        for more information.
     """
 
+    # TODO: update to site-relative /security/ after docs are ported
+
     api_resource: Resource = Field(default_factory=build_calendar_service)
 
     model_config = ConfigDict(

libs/community/langchain_google_community/calendar/update_event.py

@@ -14,7 +14,7 @@
 
 
 class UpdateEventSchema(BaseModel):
-    """Input for CalendarUpdateEvent."""
+    """Input schema for `CalendarUpdateEvent`."""
 
     event_id: str = Field(..., description="The event ID to update.")
     calendar_id: str = Field(

libs/community/langchain_google_community/docai.py

@@ -37,10 +37,20 @@ class DocAIParsingResults:
 
 
 class DocAIParser(BaseBlobParser):
-    """`Google Cloud Document AI` parser.
+    """Google Cloud Document AI parser.
 
-    For a detailed explanation of Document AI, refer to the product documentation.
-    https://cloud.google.com/document-ai/docs/overview
+    Inherits from [`BaseBlobParser`][langchain_core.document_loaders.BaseBlobParser].
+    Parses documents using Google Cloud Document AI for text extraction and
+    layout analysis.
+
+    See [Document AI documentation](https://cloud.google.com/document-ai/docs/overview)
+    for detailed information.
+
+    !!! note "Installation"
+        Requires additional dependencies:
+        ```bash
+        pip install langchain-google-community[docai]
+        ```
     """
 
     def __init__(

libs/community/langchain_google_community/documentai_warehouse.py

@@ -22,13 +22,20 @@
 
 
 class DocumentAIWarehouseRetriever(BaseRetriever):
-    """A retriever based on Document AI Warehouse.
+    """Retriever for Google Cloud Document AI Warehouse.
 
-    Documents should be created and documents should be uploaded
-        in a separate flow, and this retriever uses only Document AI
-        schema_id provided to search for relevant documents.
+    Inherits from [`BaseRetriever`][langchain_core.retrievers.BaseRetriever].
+    Searches documents using Document AI Warehouse schema. Documents must be
+    created and uploaded separately before retrieval.
 
-    More info: https://cloud.google.com/document-ai-warehouse.
+    See [Document AI Warehouse documentation](https://cloud.google.com/document-ai-warehouse)
+    for more information.
+
+    !!! note "Installation"
+        Requires additional dependencies:
+        ```bash
+        pip install langchain-google-community[docai]
+        ```
     """
 
     location: str = "us"

libs/community/langchain_google_community/drive.py

@@ -17,7 +17,17 @@
 
 
 class GoogleDriveLoader(BaseLoader, BaseModel):
-    """Load Google Docs from `Google Drive`."""
+    """Load documents from Google Drive.
+
+    Inherits from [`BaseLoader`][langchain_core.document_loaders.BaseLoader].
+    Supports loading from folders, specific documents, or file IDs with authentication.
+
+    !!! note "Installation"
+        Requires additional dependencies:
+        ```bash
+        pip install langchain-google-community[drive]
+        ```
+    """
 
     # Generated from https://developers.google.com/drive/api/guides/api-specific-auth
     # limiting to the scopes that are required to read the files

libs/community/langchain_google_community/gcs_directory.py

@@ -8,7 +8,17 @@
 
 
 class GCSDirectoryLoader(BaseLoader):
-    """Load from GCS directory."""
+    """Load documents from Google Cloud Storage directory.
+
+    Inherits from [`BaseLoader`][langchain_core.document_loaders.BaseLoader].
+    Loads all files from a GCS bucket with optional prefix filtering.
+
+    !!! note "Installation"
+        Requires additional dependencies:
+        ```bash
+        pip install langchain-google-community[gcs]
+        ```
+    """
 
     def __init__(
         self,

libs/community/langchain_google_community/gcs_file.py

@@ -9,7 +9,17 @@
 
 
 class GCSFileLoader(BaseLoader):
-    """Load from GCS file."""
+    """Load documents from Google Cloud Storage file.
+
+    Inherits from [`BaseLoader`][langchain_core.document_loaders.BaseLoader].
+    Downloads and loads a single file from GCS bucket using configurable loader.
+
+    !!! note "Installation"
+        Requires additional dependencies:
+        ```bash
+        pip install langchain-google-community[gcs]
+        ```
+    """
 
     def __init__(
         self,
@@ -28,15 +38,21 @@ def __init__(
                 file_path argument. If nothing is provided, the
                 UnstructuredFileLoader is used.
 
-        Examples:
-            To use an alternative PDF loader:
-            >> from from langchain_community.document_loaders import PyPDFLoader
-            >> loader = GCSFileLoader(..., loader_func=PyPDFLoader)
+        ??? example "Using Alternative PDF Loader"
+            ```python
+            from langchain_community.document_loaders import PyPDFLoader
 
-            To use UnstructuredFileLoader with additional arguments:
-            >> loader = GCSFileLoader(...,
-            >>      loader_func=lambda x: UnstructuredFileLoader(x, mode="elements"))
+            loader = GCSFileLoader(..., loader_func=PyPDFLoader)
+            ```
 
+        ??? example "Using UnstructuredFileLoader with Custom Arguments"
+            ```python
+            from langchain_community.document_loaders import UnstructuredFileLoader
+
+            loader = GCSFileLoader(
+                ..., loader_func=lambda x: UnstructuredFileLoader(x, mode="elements")
+            )
+            ```
         """
         self.bucket = bucket
         self.blob = blob