tidy docs

Author: edavidaja

docs/CHANGELOG.md

@@ -15,6 +15,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   When neither `-n/--name` nor `-s/--server` is provided, the default server is
   used automatically. `rsconnect login` sets the server as default unless
   `--no-set-default` is passed. `CONNECT_SERVER` still takes precedence.
+- 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
 
@@ -25,8 +27,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

@@ -725,8 +725,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
         """
@@ -748,13 +746,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 = {
@@ -780,15 +776,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] = {}
@@ -811,8 +805,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)
@@ -828,8 +820,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.
@@ -870,7 +860,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)
@@ -879,7 +869,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.
         """
@@ -1565,7 +1555,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

@@ -1731,7 +1731,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."
@@ -1750,7 +1750,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",
@@ -1761,7 +1761,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