Vscode-pull-request-github: Check out vs checkout

Created on 27 Aug 2018  路  10Comments  路  Source: microsoft/vscode-pull-request-github

Right now "check out" is used throughout but I think we should be using "checkout" as that's the underlying git operation used and it's referred to as "the checkout operation" in the docs https://git-scm.com/docs/git-checkout

image

image

ux

Most helpful comment

Let's have a vote:Checkout vs check out vote with reactions. Closing today day 5pm PST.

馃憤Checkout
馃憥Check out

All 10 comments

Agreed. It would expect Checkout PR

Interesting, https://github.com/Microsoft/vscode-pull-request-github/issues/177 . checkout is used when we are referring to the operation/command while we use Check Out as a verb.

cc @shana

Could we name the button Checkout Pull Request or Checkout PR to it use a "command" and not a verb?

From https://github.com/Microsoft/vscode-pull-request-github/issues/177#issuecomment-412611563

So on GitHub we use "check out" as a verb, and only use "checkout" when talking about the command or if talking about a specific feature with that name (like if we named a feature "the checkout button"). I don't know if the VS docs team has different guidelines for that usage tbh.

@shana where on GH is "check out" used? This is all I could find:

screen shot 2018-08-28 at 10 48 49 am

GH desktop, https://desktop.github.com/:

screen shot 2018-08-28 at 10 50 40 am

https://help.github.com/articles/checking-out-pull-requests-locally/

screen shot 2018-08-28 at 10 53 12 am

Noooooo

"the checkout operation"

"Checkout" is an adjective, "The check out operation" is wrong. That's a different case from "Check out this PR"

TBH I think those usages in github are either wrong or references to the command itself. Note that they say "Checking out" and not "Checkouting". The git docs use "Check out" except referring to the command or in the above usage.

@roblourens What's the specific concern and proposal? We have updated the wording, so it looks like:

screen shot 2018-08-30 at 11 17 29 pm

screen shot 2018-08-30 at 11 16 37 pm

screen shot 2018-08-30 at 11 16 28 pm

The screenshots look right to me.

My proposal is still to use "Check out" instead of "Checkout"

Let's have a vote:Checkout vs check out vote with reactions. Closing today day 5pm PST.

馃憤Checkout
馃憥Check out

Was this page helpful?
0 / 5 - 0 ratings

Related issues

kieferrm picture kieferrm  路  4Comments

Jonnokc picture Jonnokc  路  3Comments

Tyriar picture Tyriar  路  3Comments

joaomoreno picture joaomoreno  路  4Comments

radu-matei picture radu-matei  路  3Comments