chore(docs): add missing descriptions

Author: stainless-app[bot]

src/gitpod/_client.py

@@ -150,6 +150,10 @@ def environments(self) -> EnvironmentsResource:
 
     @cached_property
     def errors(self) -> ErrorsResource:
+        """
+        ErrorsService provides endpoints for clients to report errors
+         that will be sent to error reporting systems.
+        """
         from .resources.errors import ErrorsResource
 
         return ErrorsResource(self)
@@ -186,6 +190,10 @@ def organizations(self) -> OrganizationsResource:
 
     @cached_property
     def prebuilds(self) -> PrebuildsResource:
+        """
+        PrebuildService manages prebuilds for projects to enable faster environment startup times.
+         Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+        """
         from .resources.prebuilds import PrebuildsResource
 
         return PrebuildsResource(self)
@@ -210,6 +218,9 @@ def secrets(self) -> SecretsResource:
 
     @cached_property
     def usage(self) -> UsageResource:
+        """
+        UsageService provides usage information about environments, users, and projects.
+        """
         from .resources.usage import UsageResource
 
         return UsageResource(self)
@@ -414,6 +425,10 @@ def environments(self) -> AsyncEnvironmentsResource:
 
     @cached_property
     def errors(self) -> AsyncErrorsResource:
+        """
+        ErrorsService provides endpoints for clients to report errors
+         that will be sent to error reporting systems.
+        """
         from .resources.errors import AsyncErrorsResource
 
         return AsyncErrorsResource(self)
@@ -450,6 +465,10 @@ def organizations(self) -> AsyncOrganizationsResource:
 
     @cached_property
     def prebuilds(self) -> AsyncPrebuildsResource:
+        """
+        PrebuildService manages prebuilds for projects to enable faster environment startup times.
+         Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+        """
         from .resources.prebuilds import AsyncPrebuildsResource
 
         return AsyncPrebuildsResource(self)
@@ -474,6 +493,9 @@ def secrets(self) -> AsyncSecretsResource:
 
     @cached_property
     def usage(self) -> AsyncUsageResource:
+        """
+        UsageService provides usage information about environments, users, and projects.
+        """
         from .resources.usage import AsyncUsageResource
 
         return AsyncUsageResource(self)
@@ -629,6 +651,10 @@ def environments(self) -> environments.EnvironmentsResourceWithRawResponse:
 
     @cached_property
     def errors(self) -> errors.ErrorsResourceWithRawResponse:
+        """
+        ErrorsService provides endpoints for clients to report errors
+         that will be sent to error reporting systems.
+        """
         from .resources.errors import ErrorsResourceWithRawResponse
 
         return ErrorsResourceWithRawResponse(self._client.errors)
@@ -665,6 +691,10 @@ def organizations(self) -> organizations.OrganizationsResourceWithRawResponse:
 
     @cached_property
     def prebuilds(self) -> prebuilds.PrebuildsResourceWithRawResponse:
+        """
+        PrebuildService manages prebuilds for projects to enable faster environment startup times.
+         Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+        """
         from .resources.prebuilds import PrebuildsResourceWithRawResponse
 
         return PrebuildsResourceWithRawResponse(self._client.prebuilds)
@@ -689,6 +719,9 @@ def secrets(self) -> secrets.SecretsResourceWithRawResponse:
 
     @cached_property
     def usage(self) -> usage.UsageResourceWithRawResponse:
+        """
+        UsageService provides usage information about environments, users, and projects.
+        """
         from .resources.usage import UsageResourceWithRawResponse
 
         return UsageResourceWithRawResponse(self._client.usage)
@@ -732,6 +765,10 @@ def environments(self) -> environments.AsyncEnvironmentsResourceWithRawResponse:
 
     @cached_property
     def errors(self) -> errors.AsyncErrorsResourceWithRawResponse:
+        """
+        ErrorsService provides endpoints for clients to report errors
+         that will be sent to error reporting systems.
+        """
         from .resources.errors import AsyncErrorsResourceWithRawResponse
 
         return AsyncErrorsResourceWithRawResponse(self._client.errors)
@@ -768,6 +805,10 @@ def organizations(self) -> organizations.AsyncOrganizationsResourceWithRawRespon
 
     @cached_property
     def prebuilds(self) -> prebuilds.AsyncPrebuildsResourceWithRawResponse:
+        """
+        PrebuildService manages prebuilds for projects to enable faster environment startup times.
+         Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+        """
         from .resources.prebuilds import AsyncPrebuildsResourceWithRawResponse
 
         return AsyncPrebuildsResourceWithRawResponse(self._client.prebuilds)
@@ -792,6 +833,9 @@ def secrets(self) -> secrets.AsyncSecretsResourceWithRawResponse:
 
     @cached_property
     def usage(self) -> usage.AsyncUsageResourceWithRawResponse:
+        """
+        UsageService provides usage information about environments, users, and projects.
+        """
         from .resources.usage import AsyncUsageResourceWithRawResponse
 
         return AsyncUsageResourceWithRawResponse(self._client.usage)
@@ -835,6 +879,10 @@ def environments(self) -> environments.EnvironmentsResourceWithStreamingResponse
 
     @cached_property
     def errors(self) -> errors.ErrorsResourceWithStreamingResponse:
+        """
+        ErrorsService provides endpoints for clients to report errors
+         that will be sent to error reporting systems.
+        """
         from .resources.errors import ErrorsResourceWithStreamingResponse
 
         return ErrorsResourceWithStreamingResponse(self._client.errors)
@@ -871,6 +919,10 @@ def organizations(self) -> organizations.OrganizationsResourceWithStreamingRespo
 
     @cached_property
     def prebuilds(self) -> prebuilds.PrebuildsResourceWithStreamingResponse:
+        """
+        PrebuildService manages prebuilds for projects to enable faster environment startup times.
+         Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+        """
         from .resources.prebuilds import PrebuildsResourceWithStreamingResponse
 
         return PrebuildsResourceWithStreamingResponse(self._client.prebuilds)
@@ -895,6 +947,9 @@ def secrets(self) -> secrets.SecretsResourceWithStreamingResponse:
 
     @cached_property
     def usage(self) -> usage.UsageResourceWithStreamingResponse:
+        """
+        UsageService provides usage information about environments, users, and projects.
+        """
         from .resources.usage import UsageResourceWithStreamingResponse
 
         return UsageResourceWithStreamingResponse(self._client.usage)
@@ -938,6 +993,10 @@ def environments(self) -> environments.AsyncEnvironmentsResourceWithStreamingRes
 
     @cached_property
     def errors(self) -> errors.AsyncErrorsResourceWithStreamingResponse:
+        """
+        ErrorsService provides endpoints for clients to report errors
+         that will be sent to error reporting systems.
+        """
         from .resources.errors import AsyncErrorsResourceWithStreamingResponse
 
         return AsyncErrorsResourceWithStreamingResponse(self._client.errors)
@@ -974,6 +1033,10 @@ def organizations(self) -> organizations.AsyncOrganizationsResourceWithStreaming
 
     @cached_property
     def prebuilds(self) -> prebuilds.AsyncPrebuildsResourceWithStreamingResponse:
+        """
+        PrebuildService manages prebuilds for projects to enable faster environment startup times.
+         Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+        """
         from .resources.prebuilds import AsyncPrebuildsResourceWithStreamingResponse
 
         return AsyncPrebuildsResourceWithStreamingResponse(self._client.prebuilds)
@@ -998,6 +1061,9 @@ def secrets(self) -> secrets.AsyncSecretsResourceWithStreamingResponse:
 
     @cached_property
     def usage(self) -> usage.AsyncUsageResourceWithStreamingResponse:
+        """
+        UsageService provides usage information about environments, users, and projects.
+        """
         from .resources.usage import AsyncUsageResourceWithStreamingResponse
 
         return AsyncUsageResourceWithStreamingResponse(self._client.usage)

src/gitpod/resources/errors.py

@@ -24,6 +24,11 @@
 
 
 class ErrorsResource(SyncAPIResource):
+    """
+    ErrorsService provides endpoints for clients to report errors
+     that will be sent to error reporting systems.
+    """
+
     @cached_property
     def with_raw_response(self) -> ErrorsResourceWithRawResponse:
         """
@@ -94,6 +99,11 @@ def report_errors(
 
 
 class AsyncErrorsResource(AsyncAPIResource):
+    """
+    ErrorsService provides endpoints for clients to report errors
+     that will be sent to error reporting systems.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncErrorsResourceWithRawResponse:
         """

src/gitpod/resources/prebuilds.py

@@ -37,6 +37,11 @@
 
 
 class PrebuildsResource(SyncAPIResource):
+    """
+    PrebuildService manages prebuilds for projects to enable faster environment startup times.
+     Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+    """
+
     @cached_property
     def with_raw_response(self) -> PrebuildsResourceWithRawResponse:
         """
@@ -400,6 +405,11 @@ def create_logs_token(
 
 
 class AsyncPrebuildsResource(AsyncAPIResource):
+    """
+    PrebuildService manages prebuilds for projects to enable faster environment startup times.
+     Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncPrebuildsResourceWithRawResponse:
         """

src/gitpod/resources/usage.py

@@ -23,6 +23,10 @@
 
 
 class UsageResource(SyncAPIResource):
+    """
+    UsageService provides usage information about environments, users, and projects.
+    """
+
     @cached_property
     def with_raw_response(self) -> UsageResourceWithRawResponse:
         """
@@ -123,6 +127,10 @@ def list_environment_runtime_records(
 
 
 class AsyncUsageResource(AsyncAPIResource):
+    """
+    UsageService provides usage information about environments, users, and projects.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncUsageResourceWithRawResponse:
         """