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

Improve acme CLI options in Let's Encrypt documentation #6762

Merged
merged 1 commit into from May 4, 2020

Conversation

netoax
Copy link
Contributor

@netoax netoax commented May 3, 2020

What does this PR do?

When reading the current documentation I noticed the Let's Encrypt section shows the acme CLI flags in camelCase format instead of lowercase, which is different from other sections of documentation such as the CLI configuration reference. Because of that, this PR updates the flags to keep homogeneous documentation. Example:

From: --certificatesResolvers.<name>.acme.caServer
To: --certificatesresolvers.<name>.acme.caserver

Motivation

My main motivation is to improve the documentation in a way that avoids newcomers get confused.

More

  • Added/updated tests
  • Added/updated documentation

@ldez
Copy link
Member

ldez commented May 3, 2020

Hello,

Thank you,

The CLI flags are case insensitive, so camelCase or lowercase produce the same result.

https://docs.traefik.io/operations/cli/#general

The blocks of 4 trailing spaces are not errors but used to handle section.

@netoax
Copy link
Contributor Author

netoax commented May 3, 2020

Hello @ldez, thanks for the feedback. I didn't know about the trailing spaces being used to control section, sorry.

Is this still valuable changing the flags to keep standardization across the docs?

@ldez
Copy link
Member

ldez commented May 3, 2020

Have an homogeneous documentation is still a valuable change.

Could you restore the trailing space, thank you.

Could you also edit the PR description.

@ldez ldez added this to To review in v2 via automation May 3, 2020
@ldez ldez changed the title Fix acme CLI options in Let's Encrypt documentation Improve acme CLI options in Let's Encrypt documentation May 3, 2020
@netoax netoax force-pushed the devel_fix_lets_encrypt_docs branch from 31cfcbd to 6270158 Compare May 3, 2020 03:08
@netoax netoax force-pushed the devel_fix_lets_encrypt_docs branch from 6270158 to 090cdef Compare May 3, 2020 03:11
@netoax
Copy link
Contributor Author

netoax commented May 3, 2020

Have an homogeneous documentation is still a valuable change.

Could you restore the trailing space, thank you.

Could you also edit the PR description.

Done.

Copy link
Member

@ldez ldez left a comment

Choose a reason for hiding this comment

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

Thanks 👍

Copy link
Contributor

@dtomcej dtomcej left a comment

Choose a reason for hiding this comment

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

LGTM
:shipit:

@traefiker traefiker merged commit f12c27a into traefik:v2.2 May 4, 2020
v2 automation moved this from To review to Done May 4, 2020
@ldez ldez added the area/acme label Jun 28, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
No open projects
v2
Done
Development

Successfully merging this pull request may close these issues.

None yet

5 participants