From 3fc7b34d72db9697e01bf3367d9973f4e2686120 Mon Sep 17 00:00:00 2001
From: Angelo Ashmore <8601064+angeloashmore@users.noreply.github.com>
Date: Fri, 28 Aug 2026 03:11:50 +0000
Subject: [PATCH 1/2] docs(repo-create): explain the random domain in help text

---
 src/commands/repo-create.ts | 6 +++++-
 test/repo-create.test.ts    | 3 +++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/commands/repo-create.ts b/src/commands/repo-create.ts
index c4f607e..af19f8c 100644
--- a/src/commands/repo-create.ts
+++ b/src/commands/repo-create.ts
@@ -11,7 +11,11 @@ const MAX_DOMAIN_TRIES = 5;
 
 const config = {
 	name: "prismic repo create",
-	description: "Create a new Prismic repository.",
+	description: `
+		Create a new Prismic repository.
+
+		The CLI picks a random domain for the new repository (for example, 0b4d7321). You cannot choose or change the domain. The command prints the domain and the repository URL when it finishes.
+	`,
 	options: {
 		name: { type: "string", short: "n", description: "Display name for the repository" },
 		lang: {
diff --git a/test/repo-create.test.ts b/test/repo-create.test.ts
index e6f23bf..8ad04dd 100644
--- a/test/repo-create.test.ts
+++ b/test/repo-create.test.ts
@@ -5,6 +5,9 @@ it("supports --help", async ({ expect, prismic }) => {
 	const { stdout, stderr, exitCode } = await prismic("repo", ["create", "--help"]);
 	expect(exitCode, stderr).toBe(0);
 	expect(stdout).toContain("prismic repo create [options]");
+	expect(stdout).toContain("The CLI picks a random domain for the new repository");
+	expect(stdout).toContain("You cannot choose or change the domain");
+	expect(stdout).toContain("The command prints the domain and the repository URL when it finishes");
 });
 
 it("creates a repository", async ({ expect, prismic, token, host, password, onTestFinished }) => {

From 0403bcb3c36a6ebcb41ab8b9e0f3fd7f8ac5041d Mon Sep 17 00:00:00 2001
From: Angelo Ashmore <8601064+angeloashmore@users.noreply.github.com>
Date: Fri, 28 Aug 2026 03:24:07 +0000
Subject: [PATCH 2/2] docs(repo-create): simplify random domain wording

Drop "You cannot choose or change the domain." It sounded blunt.
Say the random domain is expected instead.
---
 src/commands/repo-create.ts | 2 +-
 test/repo-create.test.ts    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/commands/repo-create.ts b/src/commands/repo-create.ts
index af19f8c..9e93382 100644
--- a/src/commands/repo-create.ts
+++ b/src/commands/repo-create.ts
@@ -14,7 +14,7 @@ const config = {
 	description: `
 		Create a new Prismic repository.
 
-		The CLI picks a random domain for the new repository (for example, 0b4d7321). You cannot choose or change the domain. The command prints the domain and the repository URL when it finishes.
+		The CLI picks a random domain for the new repository (for example, 0b4d7321). This is expected. The command prints the domain and the repository URL when it finishes.
 	`,
 	options: {
 		name: { type: "string", short: "n", description: "Display name for the repository" },
diff --git a/test/repo-create.test.ts b/test/repo-create.test.ts
index 8ad04dd..919f267 100644
--- a/test/repo-create.test.ts
+++ b/test/repo-create.test.ts
@@ -6,7 +6,7 @@ it("supports --help", async ({ expect, prismic }) => {
 	expect(exitCode, stderr).toBe(0);
 	expect(stdout).toContain("prismic repo create [options]");
 	expect(stdout).toContain("The CLI picks a random domain for the new repository");
-	expect(stdout).toContain("You cannot choose or change the domain");
+	expect(stdout).toContain("This is expected");
 	expect(stdout).toContain("The command prints the domain and the repository URL when it finishes");
 });