Skip to content

Comments

cli doc improvements#12

Merged
tsg merged 2 commits intomainfrom
cli-improvements
May 28, 2025
Merged

cli doc improvements#12
tsg merged 2 commits intomainfrom
cli-improvements

Conversation

@alexfrancoeur
Copy link
Contributor

More detailed CLI docs

@github-actions github-actions bot temporarily deployed to Docs Preview May 27, 2025 19:38 Inactive
@github-actions github-actions bot temporarily deployed to Docs Preview May 27, 2025 19:46 Inactive
@github-actions github-actions bot temporarily deployed to Docs Preview May 27, 2025 19:50 Inactive
@alexfrancoeur alexfrancoeur requested a review from tsg May 27, 2025 19:50
@tsg
Copy link
Member

tsg commented May 27, 2025

Ah, I think these installation commands are not valid:

Screenshot 2025-05-27 at 23 21 01

Copy link
Contributor

@divyenduz divyenduz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks for this ✅

- [branch get](/cli/branch#get) - Get a field from a branch description
- [branch wait-ready](/cli/branch#wait-ready) - Wait for a branch to be ready

### Schema Migrations
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: order of the list of these comments should be start/ migrate before complete etc OR lexicographically sorted. They are random right now, feels off 🤔


```bash
xata roll start
xata roll start <file> [--lock-timeout <ms>] [--pgroll-schema <schema>] [--postgres-url <url>] [--role <role>] [--schema <schema>] [--verbose] [--backfill-batch-delay <delay>] [--backfill-batch-size <size>] [--complete] [--skip-validation] [-h|--help]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want to list all flags here? These are pgroll flags. Most of the time, I try to not list them out loud unless the user needs something specific and can use CLI help.

Maybe it is okay in a CLI reference (not sure)

@tsg
Copy link
Member

tsg commented May 28, 2025

I fixed the CLI install command in #14

@tsg tsg merged commit f4f6838 into main May 28, 2025
1 check passed
@alexfrancoeur
Copy link
Contributor Author

@divyenduz I'll open a PR to address the ordering of the flags and will open up the discussion around the pgroll flags. I could go either way.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants