-
Notifications
You must be signed in to change notification settings - Fork 8.3k
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 ConfigMap docs #1532
Comments
I will try to help out here this week, thanks for coordinating |
@pieterlange I'll try to help you with some items here. @mrrandrade will also take a look. |
@rikatz @aledbf I added a PR #1747 which provides information on usage and deployment of the config-map that way we can get new users to help with the documentation. I added all possible options and their defaults as well by looking at https://github.com/kubernetes/ingress-nginx/blob/master/internal/ingress/controller/config/config.go For future iteration of the docs maybe we can have sections in the table which point below to the actual option and provide information about it, similar to https://github.com/kubernetes/ingress-nginx/blob/master/docs/user-guide/annotations.md |
Closing. Fixed in #1747 |
I'm missing the explanation of each directive there :( |
Changes the Config-Map documentation to be easier to search and follow a format similar to that in the annotations section. Also adds some missing configuration options. Fixes kubernetes#1532
Is this a BUG REPORT or FEATURE REQUEST? (choose one): Bug Report / Docs Improvement
As @aledbf is making his brave journey to improve Ingress Docs in #1527 (which we're really thank to!), I've been digging some undocumented / misdocumented ConfigMap directives that should be documented after the PR above is closed.
Some of those ConfigMap directives only exists in the code, as other exists also in configuration.md but there's no default value, or only the default value and no explanation, and some have both but there's no how to use them.
This is a issue of multiple PRs, and needs help from everyone (no need to know how to code in Go, but need to know what's the impact of each directive).
I'm putting them as a list, so we can 'check' each completed box/documented directive.
Undocumented directives/Missing explanation:
Documentation improvements
The text was updated successfully, but these errors were encountered: