Skip to content

Meta Docker ID topic#634

Merged
johndmulhausen merged 1 commit intodocker:masterfrom
sanscontext:dockerid
Nov 18, 2016
Merged

Meta Docker ID topic#634
johndmulhausen merged 1 commit intodocker:masterfrom
sanscontext:dockerid

Conversation

@sanscontext
Copy link
Contributor

This is an adaptation of the current Hub doc on signing up and logging in. We don't (yet) have a central page for login, so I'm using the Cloud page. Also provides links to the Accounts API page where it currently lives (@bfirsh I know you're moving it).

I'm not sure if there's a better way to make the Docker ID a section ( @johndmulhausen ?) , or if we really want it up at the top.

PTAL @docker/docs-maintainers

Signed-off-by: LRubin [email protected]

@johndmulhausen
Copy link
Contributor

johndmulhausen commented Nov 18, 2016

---

Your free Docker ID grants you access to Docker services such as the Docker
Store, Docker Cloud, Docker Hub repositories, and some beta programs. Your Docker ID becomes repository namespace used by hosted services such as Docker Hub and Docker Cloud. All you need is an email address.

Choose a reason for hiding this comment

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

nit: long lines


3. Click **Sign Up**.

Docker sends a verification email to the address you provided.

Choose a reason for hiding this comment

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

nit: misalignment may cause the list to go funny.


2. Enter a username, a valid email address, and a password.

3. Click **Sign Up**.

Choose a reason for hiding this comment

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

why not collapse steps 2 and 3?


Docker sends a verification email to the address you provided.

> **Note**: You must click this link to activate your account. You cannot log in with your Docker ID until you verify your email address.

Choose a reason for hiding this comment

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

Seems funny to say you must click the link before telling them to click the link in the next step?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Copypasta. Fixed.


## Login

Once you register for a Docker ID and verify your email address, you can log in

Choose a reason for hiding this comment

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

consider s/you can log in/log in

Copy link
Contributor Author

Choose a reason for hiding this comment

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

You can, because there's plenty of stuff you can access without having logged in.


![Login using the web interface](images/login-cloud.png)

Or by using the the `docker login` command. (You can read more about `docker login` [here](../engine/reference/commandline/login/) )

Choose a reason for hiding this comment

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

Incomplete sentence. Maybe something like "To log in using the the Docker CLI,..."

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Artifact of previous writing. Fixed.

Or by using the the `docker login` command. (You can read more about `docker login` [here](../engine/reference/commandline/login/) )

> **Note:** When you use the `docker login` command, your authentication
> credentials are stored in the `.dockercfg` file in your home directory.

Choose a reason for hiding this comment

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

Are they stored as plain text?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hashed

@johndmulhausen
Copy link
Contributor

johndmulhausen commented Nov 18, 2016

A few things:

  1. Keywords should be a string:
keywords: foo, bar, etc

The Rosebud people will send bot-generated PRs later if you don't fix it here.
2. I know this supersedes login information in a few places; can you delete the information in those places and add redirect_from: metadata to this new topic so we don't have cruft?
3. Can you make the title less about a thing with a name ("Docker ID accounts") and more about what its use case is? If not - wouldn't the better term be "Docker accounts" rather than "Docker ID accounts"?
4. description should be a sentence that describes the topic.

@sanscontext
Copy link
Contributor Author

@johndmulhausen for 2: At this point the Docker ID information is intermingled with information about what you get with your Docker ID for each account. That'll be a longer term project. It's easy to remove it for Hub, but less so for Cloud.

  1. Docker ID is the brand/product name that we want to surface. I added "Accounts" because without it, we have a section called "Docker ID" and the subtopic is also "Docker ID".

Copy link
Contributor

@johndmulhausen johndmulhausen left a comment

Choose a reason for hiding this comment

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

(Obsolete comment that GitHub won't let me delete)

@johndmulhausen johndmulhausen dismissed stale reviews from ghost and themself November 18, 2016 22:44

Talked about things in person

@johndmulhausen johndmulhausen merged commit d1c99d6 into docker:master Nov 18, 2016
@johndmulhausen johndmulhausen self-assigned this Nov 18, 2016
@thaJeztah
Copy link
Member

@johndmulhausen regarding "keywords" (and to an extend "description"); Do we actually still need those? AFAIK, Google doesn't use them, and ranking / relevancy is based on Title and actual content of the page.

If I'm right here, I'd really prefer to get rid of them, as it's easy for them to get outdated, so would save a lot of maintenance.

e.g.;

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.

4 participants