tidy docs

Author: edavidaja

docs/CHANGELOG.md

@@ -16,6 +16,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   used automatically. `rsconnect login` sets the server as default unless
   `--no-set-default` is passed. `CONNECT_SERVER` still takes precedence.
 - New `environment` subcommand for managing execution environments on Connect.
+- Added `rsconnect deploy git` command to create a [git-backed deployment](https://docs.posit.co/connect/user/git-backed/).
+  Use `--branch` to specify a branch (default: main) and `--subdirectory` to deploy content from a subdirectory.
 
 ## [1.29.0] - 2026-04-29
 
@@ -26,8 +28,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- Added `rsconnect deploy git` command to create a [git-backed deployment](https://docs.posit.co/connect/user/git-backed/).
-  Use `--branch` to specify a branch (default: main) and `--subdirectory` to deploy content from a subdirectory.
 - `rsconnect content get-lockfile` command allows fetching a lockfile with the
   dependencies installed by connect to run the deployed content
 - `rsconnect content venv` command recreates a local python environment

rsconnect/api.py

@@ -730,8 +730,6 @@ def content_deploy(
     def get_repository(self, content_guid: str) -> Optional[RepositoryInfo]:
         """Get git repository configuration for a content item.
 
-        GET /v1/content/{guid}/repository
-
         :param content_guid: The GUID of the content item
         :return: Repository configuration if git-managed, None otherwise
         """
@@ -753,13 +751,11 @@ def set_repository(
     ) -> RepositoryInfo:
         """Create or overwrite git repository configuration for a content item.
 
-        PUT /v1/content/{guid}/repository
-
         :param content_guid: The GUID of the content item
         :param repository: URL of the git repository (https:// only)
         :param branch: Branch to deploy from (default: main)
         :param directory: Directory containing manifest.json (default: .)
-        :param polling: Enable auto-redeploy when commits are pushed (default: True)
+        :param polling: Whether the git repository should be regularly polled (default: True)
         :return: The repository configuration
         """
         body = {
@@ -785,15 +781,13 @@ def update_repository(
     ) -> RepositoryInfo:
         """Partially update git repository configuration for a content item.
 
-        PATCH /v1/content/{guid}/repository
-
         Only fields that are provided will be updated.
 
         :param content_guid: The GUID of the content item
         :param repository: URL of the git repository (https:// only)
         :param branch: Branch to deploy from
         :param directory: Directory containing manifest.json
-        :param polling: Enable auto-redeploy when commits are pushed
+        :param polling: Whether the git repository should be regularly polled
         :return: The updated repository configuration
         """
         body: dict[str, str | bool] = {}
@@ -816,8 +810,6 @@ def update_repository(
     def delete_repository(self, content_guid: str) -> None:
         """Remove git repository configuration from a content item.
 
-        DELETE /v1/content/{guid}/repository
-
         :param content_guid: The GUID of the content item
         """
         response = self.delete("v1/content/%s/repository" % content_guid)
@@ -833,8 +825,6 @@ def create_bundle_from_repository(
     ) -> RepositoryBundleOutput:
         """Create a bundle from a git repository location.
 
-        POST /v1/content/{guid}/repository/bundle
-
         This triggers Connect to clone the repository and create a bundle.
         If the content item has existing git configuration, those values are used
         as defaults; provided parameters will override them.
@@ -875,7 +865,7 @@ def deploy_git(
         """Deploy content from a git repository.
 
         Creates or updates a git-backed content item in Posit Connect. Connect will clone
-        the repository and automatically redeploy when commits are pushed (if polling is enabled).
+        the repository and regularly poll it for updates.
 
         :param app_id: Existing content ID/GUID to update, or None to create new content
         :param name: Name for the content item (used if creating new)
@@ -884,7 +874,7 @@ def deploy_git(
         :param subdirectory: Subdirectory containing manifest.json
         :param title: Title for the content
         :param env_vars: Environment variables to set
-        :param polling: Enable auto-redeploy when commits are pushed (default: True)
+        :param polling: Whether the git repository should be regularly polled (default: True)
         :param activate: Whether to activate the deployment (False = draft mode)
         :return: Deployment result with task_id, app info, etc.
         """
@@ -1617,7 +1607,7 @@ def deploy_git(self, activate: bool = True):
         """Deploy content from a remote git repository.
 
         Creates a git-backed content item in Posit Connect. Connect will clone
-        the repository and automatically redeploy when commits are pushed.
+        the repository and regularly poll it for updates.
         """
         if not isinstance(self.client, RSConnectClient):
             raise RSConnectException(

rsconnect/main.py

@@ -1739,7 +1739,7 @@ def deploy_manifest(
     help=(
         "Deploy content to Posit Connect directly from a remote Git repository. "
         "The repository must contain a manifest.json file (in the root or specified subdirectory). "
-        "Connect will periodically check for updates and redeploy automatically when commits are pushed."
+        "Connect will regularly poll the repository for updates."
         "\n\n"
         "This command creates a new git-backed content item. To update an existing git-backed "
         "content item, use the --app-id option with the content's GUID."
@@ -1758,7 +1758,7 @@ def deploy_manifest(
     "--branch",
     "-b",
     default="main",
-    help="Branch to deploy from. Connect auto-deploys when commits are pushed. [default: main]",
+    help="Branch to deploy from. [default: main]",
 )
 @click.option(
     "--subdirectory",
@@ -1769,7 +1769,7 @@ def deploy_manifest(
 @click.option(
     "--polling/--no-polling",
     default=True,
-    help="Enable/disable automatic redeployment when commits are pushed to the repository. [default: enabled]",
+    help="Enable/disable regular polling of the repository for updates. [default: enabled]",
 )
 @cli_exception_handler
 @click.pass_context