docs: fix logger documentation (#100)

* docs: fix documentation for logger

* chore: blacken

docs/conf.py

@@ -345,10 +345,10 @@
 
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {
-    "python": ("http://python.readthedocs.org/en/latest/", None),
-    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "python": ("https://python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://googleapis.dev/python/google-auth/latest/", None),
     "google.api_core": ("https://googleapis.dev/python/google-api-core/latest/", None,),
-    "grpc": ("https://grpc.io/grpc/python/", None),
+    "grpc": ("https://grpc.github.io/grpc/python/", None),
     "proto-plus": ("https://proto-plus-python.readthedocs.io/en/latest/", None),
 }
 

google/cloud/logging_v2/logger.py

@@ -43,12 +43,13 @@
 
 
 class Logger(object):
-    def __init__(self, name, client, *, labels=None):
-        """Loggers represent named targets for log entries.
+    """Loggers represent named targets for log entries.
 
-        See
-        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs
+    See https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs
+    """
 
+    def __init__(self, name, client, *, labels=None):
+        """
         Args:
             name (str): The name of the logger.
             client (~logging_v2.client.Client):
@@ -57,7 +58,6 @@ def __init__(self, name, client, *, labels=None):
             labels (Optional[dict]): Mapping of default labels for entries written
                 via this logger.
 
-
         """
         self.name = name
         self._client = client
@@ -247,6 +247,7 @@ def list_entries(
                     "organizations/[ORGANIZATION_ID]"
                     "billingAccounts/[BILLING_ACCOUNT_ID]"
                     "folders/[FOLDER_ID]"
+
                 If not passed, defaults to the project bound to the client.
             filter_ (Optional[str]): a filter expression. See
                 https://cloud.google.com/logging/docs/view/advanced_filters