This seemed to be causing other weird spacing / rendering as well
od -c shows
0026020 a d m i n f i l e \n # ** @ p
0026040 a r a m l o o p b a c k _ u s
0026060 e r s T h i s o p t i o n
Attached is a pretty self contained repo case, tho haven't been able to replicate the case (probably can be replicated with above config) where some examples don't get rendered. If you add a "# foo" at the top, you'll see the missing docs line end up there.
Sorry for the delayed response, but this appears to be an issue in the underlying YARD gem's ability to detect documentation tags that include non-standard whitespace characters. I would suggest following up with https://github.com/lsegal/yard if this continues to be an issue for you.
Please feel free to re-open this issue if you are sure it is a problem specific to puppet-strings.