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

Small changes to Services doc #12141

Merged
merged 1 commit into from
Aug 18, 2015
Merged

Conversation

gmarek
Copy link
Contributor

@gmarek gmarek commented Aug 3, 2015

I found this part of the doc really confusing and tried to make it a bit better.

@gmarek gmarek added the kind/documentation Categorizes issue or PR as related to documentation. label Aug 3, 2015
@k8s-bot
Copy link

k8s-bot commented Aug 3, 2015

GCE e2e build/test passed for commit 27585945d6a264083e23181814b3db449b61d76f.

@k8s-bot
Copy link

k8s-bot commented Aug 3, 2015

GCE e2e build/test failed for commit 47c283b6ce5685dd98a1842e752e0b65fc742731.

@gmarek
Copy link
Contributor Author

gmarek commented Aug 3, 2015

cc @thockin

node of the cluster (the same port on each node)
* `LoadBalancer`: use a ClusterIP and a NodePort, but also ask the cloud
provider for a load balancer which forwards to the `Service`
discussed above. Choosing this value means that you want this to be the only
Copy link
Member

Choose a reason for hiding this comment

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

Your expansions here are good (thanks). I think the flow from "Service Types" to "External Services" to "Details about Service Types" is a bit awkward.

What if this restructured as:

## Publishing services - service types

For some parts of your app...

Every service has a type...

### Type NodePort

It still feels a little redundant to describe the types in fair detail only to follow up with a sub-chapter on each type half a page later...

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done. @thockin PTAL.

@gmarek gmarek force-pushed the service_doc branch 2 times, most recently from 8d2f01f to 8fc74b9 Compare August 3, 2015 17:21
@k8s-bot
Copy link

k8s-bot commented Aug 3, 2015

GCE e2e build/test passed for commit 8d2f01f3858b0a42d77b40705b58a2c57205e9f6.

@alex-mohr
Copy link
Contributor

@thockin commented, so assuming assigning is ok.

@k8s-bot
Copy link

k8s-bot commented Aug 3, 2015

GCE e2e build/test passed for commit 8fc74b976518432c0e001163b76fcb82577f4353.

@k8s-bot
Copy link

k8s-bot commented Aug 3, 2015

GCE e2e build/test passed for commit 7e02390bd70ab035d77b5ce44798cb94de70506b.

@gmarek
Copy link
Contributor Author

gmarek commented Aug 5, 2015

@thockin PTAL

@gmarek
Copy link
Contributor Author

gmarek commented Aug 10, 2015

Ping @thockin

node of the cluster (the same port on each node)
* `LoadBalancer`: use a ClusterIP and a NodePort, but also ask the cloud
provider for a load balancer which forwards to the `Service`
Kubernetes `ServiceTypes` allows you to specify what kind of service you want.
Copy link
Member

Choose a reason for hiding this comment

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

grammar and styling: "ServiceTypes allow ..." the type name is ServiceType (singular), but since you pluralize it, change "allows" to "allow". Yay English.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done.

@k8s-bot
Copy link

k8s-bot commented Aug 10, 2015

GCE e2e build/test passed for commit acf788b.

@gmarek
Copy link
Contributor Author

gmarek commented Aug 12, 2015

@thockin PTAL

@gmarek
Copy link
Contributor Author

gmarek commented Aug 14, 2015

Ping @thockin

@thockin thockin added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 17, 2015
@thockin
Copy link
Member

thockin commented Aug 17, 2015

lgtm

roberthbailey added a commit that referenced this pull request Aug 18, 2015
Small changes to Services doc
@roberthbailey roberthbailey merged commit 60e17a5 into kubernetes:master Aug 18, 2015
@gmarek gmarek deleted the service_doc branch August 30, 2016 09:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind/documentation Categorizes issue or PR as related to documentation. lgtm "Looks good to me", indicates that a PR is ready to be merged.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants