Document URL: https://docs.openshift.com/enterprise/latest/admin_guide/limits.html

Section Number and Name: 

Describe the issue: 
  The documentation needs to emphasize better how the limitranges work. The documentation can be leading in that setting a min and max means that your pod can use between this min and max amount of resources, this is incorrect.  

Suggestions for improvement: 

   If a container or pod requests a limit, or gets assigned a limit then that limit is the max amount of resources that a pod or container can consume.

   Setting a min and max just means that the pod or container can request setting a limit that falls in between those values but what ever limit it requests is the max amount of resources that a pod or container can consume.

   Real world examples would help. For example if I have this config in place here are a couple scenarios you would see. 


Additional information: 

See bug 1358497 for more information. 

https://bugzilla.redhat.com/show_bug.cgi?id=1358497#c11