d871f4409b
Per discussion in #770 and on Slack, create a list of known annotations across various Ingress controller implementations. This will (hopefully) increase compatibility across implementations and reduce the need for users to change all their annotations when changing Ingress controllers. |
||
|---|---|---|
| .. | ||
| dev | ||
| faq | ||
| admin.md | ||
| annotations.md | ||
| catalog.md | ||
| README.md | ||
| troubleshooting.md | ||
Ingress documentation and examples
This directory contains documentation.
File naming convention
Try to create a README file in every directory containing documentation and index out from there, that's what readers will notice first. Use lower case for other file names unless you have a reason to draw someones attention to it. Avoid CamelCase.
Rationale:
-
Files that are common to all controllers, or heavily index other files, are named using ALL CAPS. This is done to indicate to the user that they should visit these files first. Examples include PREREQUISITES and README.
-
Files specific to a controller, or files that contain information about various controllers, are named using all lower case. Examples include configuration and catalog files.