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

doc: de-duplicate instructions in kind and hubble getting started guides #12210

Merged
merged 1 commit into from Jun 19, 2020

Conversation

rolinh
Copy link
Member

@rolinh rolinh commented Jun 19, 2020

These 2 guides have a lot of instructions in common as the Hubble guide
instructs to create a sandbox environment using Kind. This commit
ensures that instructions are not duplicated in the two guides but are
included from separate files from the 2 guides.

In addition to this, this commit also updates the instructions about
possible conflict of IP address when deploying a cluster with Kind: the
"tip" has been moved to the "Configure Kind" section as the fix needs to
be applied when configuring Kind.

Moreover, remove the "Optional" wording with regard to pre-loading the
cilium image into the Kind cluster.

@rolinh rolinh added area/documentation Impacts the documentation, including textual changes, sphinx, or other doc generation code. release-note/misc This PR makes changes that have no direct user impact. needs-backport/1.8 labels Jun 19, 2020
@rolinh rolinh requested a review from a team as a code owner June 19, 2020 17:06
@maintainer-s-little-helper maintainer-s-little-helper bot added this to In progress in 1.8.0 Jun 19, 2020
@maintainer-s-little-helper maintainer-s-little-helper bot added this to Needs backport from master in 1.8.0 Jun 19, 2020
Copy link
Contributor

@michi-covalent michi-covalent left a comment

Choose a reason for hiding this comment

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

lgtm, a couple of non-blocking minor nits

Documentation/gettingstarted/kind.rst Outdated Show resolved Hide resolved
Documentation/gettingstarted/kind-install.rst Outdated Show resolved Hide resolved
@coveralls
Copy link

coveralls commented Jun 19, 2020

Coverage Status

Coverage decreased (-0.01%) to 37.133% when pulling f4d7847 on pr/rolinh/doc-kind-hubble-gsg-dedup into 93d32dd on master.

Copy link
Member

@joestringer joestringer left a comment

Choose a reason for hiding this comment

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

Looks good, thanks for tidying this up.

A made some minor suggestions below to use imperative sense to simplify the language on the steps necessary to install Helm. (I realise they're not all from this PR, but I think that they clarify the wording).

I also made some suggestions on the use of sphinx directives for syntax highlighting, things like .. parsed-literal usage when literals are not passed.

Documentation/gettingstarted/kind-install.rst Outdated Show resolved Hide resolved
Documentation/gettingstarted/kind-preload.rst Show resolved Hide resolved
Documentation/gettingstarted/hubble.rst Outdated Show resolved Hide resolved
Documentation/gettingstarted/kind.rst Show resolved Hide resolved
Documentation/gettingstarted/kind-preload.rst Outdated Show resolved Hide resolved
@rolinh rolinh force-pushed the pr/rolinh/doc-kind-hubble-gsg-dedup branch from ad67f34 to 1b564fc Compare June 19, 2020 19:31
@rolinh rolinh requested a review from joestringer June 19, 2020 19:32
Copy link
Member

@joestringer joestringer left a comment

Choose a reason for hiding this comment

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

LGTM, looks like the CI is just complaining on one minor spelling point because it doesn't know the word Preload.

These 2 guides have a lot of instructions in common as the Hubble guide
instructs to create a sandbox environment using Kind. This commit
ensures that instructions are not duplicated in the two guides but are
included from separate files from the 2 guides.

In addition to this, this commit also updates the instructions about
possible conflict of IP address when deploying a cluster with Kind: the
"tip" has been moved to the "Configure Kind" section as the fix needs to
be applied when configuring Kind.

Moreover, remove the "Optional" wording with regard to pre-loading the
cilium image into the Kind cluster.

Signed-off-by: Robin Hahling <robin.hahling@gw-computing.net>
@rolinh rolinh force-pushed the pr/rolinh/doc-kind-hubble-gsg-dedup branch from 1b564fc to f4d7847 Compare June 19, 2020 19:51
@joestringer joestringer merged commit de01754 into master Jun 19, 2020
1.8.0 automation moved this from In progress to Merged Jun 19, 2020
@joestringer joestringer deleted the pr/rolinh/doc-kind-hubble-gsg-dedup branch June 19, 2020 19:57
@maintainer-s-little-helper maintainer-s-little-helper bot moved this from Needs backport from master to Backport pending to v1.8 in 1.8.0 Jun 21, 2020
@maintainer-s-little-helper maintainer-s-little-helper bot moved this from Needs backport from master to Backport pending to v1.8 in 1.8.0 Jun 21, 2020
@aanm aanm mentioned this pull request Jun 21, 2020
@maintainer-s-little-helper maintainer-s-little-helper bot moved this from Backport pending to v1.8 to Backport done to v1.8 in 1.8.0 Jun 22, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/documentation Impacts the documentation, including textual changes, sphinx, or other doc generation code. release-note/misc This PR makes changes that have no direct user impact.
Projects
No open projects
1.8.0
  
Merged
1.8.0
Backport done to v1.8
Development

Successfully merging this pull request may close these issues.

None yet

5 participants