Several documentation-related fields are only used in manpage and markdown docs, but not script --help, -h output. For example, the fields (before|after)_help, (before|after)_long_help, and example.
I encountered this when trying to show examples near the end of some script --help output.
IMHO, when a script learnt --help, -h options, one also expects its help output content as rich as a full doc.