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

docs: remove incorrect statement about DIND not working #13781

Merged
merged 1 commit into from
Oct 22, 2024

Conversation

agilgur5
Copy link

@agilgur5 agilgur5 commented Oct 18, 2024

Fixes #13010 (comment), #10778 (comment)

Motivation

As users have mentioned, DIND does still work and the specific DIND image used comes with Docker Engine and so does not rely on the k8s container engine

Modifications

  • replace the dockershim note with one about "Alternatives", since DIND is still not as secure

    • use a proper admonition for the note as well, instead of "Note:" with a horizontal rule after
  • also follow docs style guide for the rest of the page while at it

    • prefer 1 sentence per line, per style guide
    • use active voice, per k8s style guide
    • simple and direct, per k8s style guide
    • consistently address the user as "you" (instead of using both "you" and "we"), per k8s style guide
    • not in the style guide, but link to GH instead of raw.github as GH is much nicer to read (e.g. syntax highlighting, line numbers, etc etc) and won't auto-download a file on certain browsers (both especially for mobile)
  • add a link to the sidecar docs when it is mentioned as well

Verification

make docs passes

@agilgur5 agilgur5 added the area/docs Incorrect, missing, or mistakes in docs label Oct 18, 2024
- as users have mentioned, it does still work and the image used was one that comes with Docker Engine and so does not rely on the k8s container engine
- replace with a note about "Alternatives", since DIND is still not as secure
  - use a proper admonition for the note as well, instead of "Note:" with a horizontal rule after

- also follow docs style guide for the rest of the page while at it
  - prefer 1 sentence per line, per [style guide](https://argo-workflows.readthedocs.io/en/release-3.5/doc-changes/)
  - use active voice, per [k8s style guide](https://kubernetes.io/docs/contribute/style/style-guide/#use-active-voice)
  - simple and direct, per [k8s style guide](https://kubernetes.io/docs/contribute/style/style-guide/#use-simple-and-direct-language)
  - consistently address the user as "you" (instead of using both "you" and "we"), per [k8s style guide](https://kubernetes.io/docs/contribute/style/style-guide/#address-the-reader-as-you)

Signed-off-by: Anton Gilgur <[email protected]>
@agilgur5 agilgur5 force-pushed the docs-remove-incorrect-dind-note branch from c99886b to c68e67a Compare October 18, 2024 05:37
@joebowbeer
Copy link
Contributor

Thanks for doing this.

Copy link
Member

@Joibel Joibel left a comment

Choose a reason for hiding this comment

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

Thanks.

@agilgur5 agilgur5 merged commit d7b19d7 into argoproj:main Oct 22, 2024
19 checks passed
@agilgur5 agilgur5 deleted the docs-remove-incorrect-dind-note branch October 22, 2024 14:27
@agilgur5 agilgur5 added this to the v3.5.x patches milestone Oct 22, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/docs Incorrect, missing, or mistakes in docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants