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

Update debug-service.md's tasks file to remove $ from kubectl and turn questions into bullet list #12798

Merged

Conversation

DanyC97
Copy link
Contributor

@DanyC97 DanyC97 commented Feb 22, 2019

This PR bring the file code in line with the style guide where i've deleted $ in front of kubectl
This PR is one of the #12740 's tasks

@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. language/en Issues or PRs related to English language labels Feb 22, 2019
@DanyC97
Copy link
Contributor Author

DanyC97 commented Feb 22, 2019

/assign @zacharysarah

@netlify
Copy link

netlify bot commented Feb 22, 2019

Deploy preview for kubernetes-io-master-staging ready!

Built with commit 5b4c0fa

https://deploy-preview-12798--kubernetes-io-master-staging.netlify.com

@@ -7,8 +7,7 @@ title: Debug Services
---

{{% capture overview %}}
An issue that comes up rather frequently for new installations of Kubernetes is
that a `Service` is not working properly. You've run your `Deployment` and
An issue that comes up rather frequently for new installations of Kubernetes is that a `Service` is not working properly. You've run your `Deployment` and
created a `Service`, but you get no response when you try to access it.
This document will hopefully help you to figure out what's going wrong.
Copy link
Contributor

Choose a reason for hiding this comment

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

why change?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

is just cosmetic and not have a line with a single world in it. I know and understand from UX there is no difference however it just flows when you're in edit mode so to speak.

you agree ?

Copy link
Contributor

Choose a reason for hiding this comment

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

@DanyC97 Consider two things:

  1. Scope creep

As you say, the line change is cosmetic rather than falling within the original scope of the proposed changes. Isolation of concerns is a good thing to achieve here.

  1. Consistency

There are other lines where you changed content but didn't also remove line breaks in sentences. If you're going to make cosmetic changes, I'd like to see them consistently applied, at least within the scope of the PR if not the whole document. (And again, scope creep.)

I think removing arbitrary line breaks is a helpful change; I just want to see it applied consistently as a separate PR. Make sense?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

ack, will stick with the initial scope and follow up with the cosmetics on a different PR

@DanyC97
Copy link
Contributor Author

DanyC97 commented Feb 25, 2019

any help here with reviewing please ?

Copy link
Contributor

@zacharysarah zacharysarah left a comment

Choose a reason for hiding this comment

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

@DanyC97 Thanks for opening this PR. This looks good! I have two pieces of feedback:

  1. This comment about scope creep and consistency
  2. Be careful of using "fix" in the PR description; it's a GitHub magic word and will close Task topic - consistency around having full url to examples #12740, which I see you're using as an umbrella issue, before all of its component topics are addressed.

@DanyC97 DanyC97 force-pushed the tasks-debug-app-cluster-dsvc branch from 1383444 to ecc9447 Compare February 26, 2019 09:44
@DanyC97 DanyC97 changed the title Update debug-service.md's tasks file and remove $ from kubectl. also … Update debug-service.md's tasks file and remove $ from kubectl Feb 26, 2019
@k8s-ci-robot k8s-ci-robot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Feb 26, 2019
@DanyC97
Copy link
Contributor Author

DanyC97 commented Feb 26, 2019

@zacharysarah please help review, PR re-done following previous comments.

@DanyC97 DanyC97 force-pushed the tasks-debug-app-cluster-dsvc branch from ecc9447 to 1329841 Compare February 26, 2019 09:49
@k8s-ci-robot k8s-ci-robot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Feb 26, 2019
@DanyC97 DanyC97 changed the title Update debug-service.md's tasks file and remove $ from kubectl Update debug-service.md's tasks file to remove $ from kubectl and turn questions into bullet list Feb 26, 2019
@DanyC97 DanyC97 force-pushed the tasks-debug-app-cluster-dsvc branch from 1329841 to 5b4c0fa Compare February 26, 2019 09:52
@DanyC97
Copy link
Contributor Author

DanyC97 commented Feb 28, 2019

gentle reminder, thanks

@zacharysarah
Copy link
Contributor

@DanyC97 Thanks for incorporating feedback.

/lgtm
/approve

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Feb 28, 2019
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: zacharysarah

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Feb 28, 2019
@k8s-ci-robot k8s-ci-robot merged commit f0d8c8a into kubernetes:master Feb 28, 2019
@DanyC97 DanyC97 deleted the tasks-debug-app-cluster-dsvc branch February 28, 2019 11:03
kwiesmueller pushed a commit to kwiesmueller/website that referenced this pull request Feb 28, 2019
krmayankk pushed a commit to krmayankk/kubernetes.github.io that referenced this pull request Mar 11, 2019
yagonobre pushed a commit to yagonobre/website that referenced this pull request Mar 14, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language lgtm "Looks good to me", indicates that a PR is ready to be merged. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants