When the previous paragraph says that postStart hooks are
fired asynchronously, and this paragraph says "the behavior is
much the same for preStop hooks," it reads as saying that
preStop hooks are fired asynchronously as well–which is not true.
It also seems prudent to give a concrete example of how
terminationGracePeriodSeconds applies to the total time it takes the
preStop hook and the container shutdown to happen.
Andrew Garrett
22a5ff9fdb