Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Misc 21.1.1 CLI updates #10805

Merged
merged 2 commits into from
Jun 30, 2021
Merged

Misc 21.1.1 CLI updates #10805

merged 2 commits into from
Jun 30, 2021

Conversation

ericharmeling
Copy link
Contributor

@ericharmeling ericharmeling commented Jun 21, 2021

Fixes #10661.
Fixes #10660.
Fixes #10659.
Fixes #10658.
Fixes #9142.
Fixes #9143.
Fixes #9131.

This PR includes changes to the CLI reference docs for cockroach sql and cockroach demo, and updates to examples affected by the changes linked in the cockroach PRs above.

@cockroach-teamcity
Copy link
Member

This change is Reviewable

@netlify
Copy link

netlify bot commented Jun 21, 2021

✔️ Netlify Preview

🔨 Explore the source changes: 7f979f1

🔍 Inspect the deploy log: https://app.netlify.com/sites/cockroachdb-docs/deploys/60dcae926327fa000843058a

😎 Browse the preview: https://deploy-preview-10805--cockroachdb-docs.netlify.app

@ericharmeling ericharmeling requested a review from knz June 21, 2021 20:16
Copy link
Contributor

@knz knz left a comment

Choose a reason for hiding this comment

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

Reviewed 26 of 26 files at r1.
Reviewable status: :shipit: complete! 0 of 0 LGTMs obtained (waiting on @ericharmeling)

@ericharmeling
Copy link
Contributor Author

TFTR @knz !

@ericharmeling ericharmeling requested a review from mikeCRL June 22, 2021 11:17
Copy link
Contributor

@mikeCRL mikeCRL left a comment

Choose a reason for hiding this comment

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

Just one question that pertains to all the instances of <br><br>.

@@ -1,8 +1,8 @@
Flag | Description
-----|------------
`--host` | The server host and port number to connect to. This can be the address of any node in the cluster. <br><br>**Env Variable:** `COCKROACH_HOST`<br>**Default:** `localhost:26257`
`--port`<br>`-p` | The server port to connect to. Note: The port number can also be specified via `--host`. <br><br>**Env Variable:** `COCKROACH_PORT`<br>**Default:** `26257`
`--user`<br>`-u` | The [SQL user](create-user.html) that will own the client session.<br><br>**Env Variable:** `COCKROACH_USER`<br>**Default:** `root`
`--port`<br><br>`-p` | The server port to connect to. Note: The port number can also be specified via `--host`. <br><br>**Env Variable:** `COCKROACH_PORT`<br>**Default:** `26257`
Copy link
Contributor

Choose a reason for hiding this comment

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

Why the extra line break? I think it looks good as-is on the live site. The meaning (that they're alternates/synonyms) is clear to me.

Copy link
Contributor Author

@ericharmeling ericharmeling left a comment

Choose a reason for hiding this comment

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

Reviewable status: :shipit: complete! 0 of 0 LGTMs obtained (waiting on @mikeCRL)


_includes/v21.1/sql/connection-parameters.md, line 4 at r1 (raw file):

Previously, mikeCRL (Mike Lewis) wrote…

Why the extra line break? I think it looks good as-is on the live site. The meaning (that they're alternates/synonyms) is clear to me.

I noticed that a single line break makes the options difficult to parse if one of the options runs on to the next line (the formatting makes it look like there is an additional option). Having double spaces accommodates this case, but it looks a bit odd if just one or two of the columns with multiple options have the double line break. So I tried to update all of these to be consistent.

This could for sure be a style discussion for reference tables with multiple items with the same description.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
4 participants