this is also tracked in https://github.com/puppetlabs/puppet-resource_api/issues/208
This might be because puppet requires the top level description to end with a ".", see PUP-2641
PUP-2641 does not happen in 6.10.1 anymore (I've manually removed the last "." from the java_ks type to test):
david@davids:~/git/puppetlabs-java_ks$ bundle exec puppet describe --libdir ./lib java_ks | head
java_ks
=======
Manages the entries in a java keystore, and uses composite namevars to
accomplish the same alias spread across multiple target keystores
Parameters
----------
david@davids:~/git/puppetlabs-java_ks$ puppet --version
6.10.1
david@davids:~/git/puppetlabs-java_ks$ git describe --all --long
heads/master-0-gee1531a
david@davids:~/git/puppetlabs-java_ks$
and even with a dot at the end of the description (https://github.com/puppetlabs/puppetlabs-panos/blob/7f99a79294ab6601af3d1c3069712e604e85ad13/lib/puppet/type/panos_nat_policy.rb#L6) puppet describe still fails with this panos type:
david@davids:~/git/puppetlabs-panos$ bundle exec puppet describe panos_nat_policy --libdir ./lib | head
panos_nat_policy
================
- **bi_directional**
david@davids:~/git/puppetlabs-panos$ puppet --version
david@davids:~/git/puppetlabs-panos$ git describe --all --long
heads/master-0-g7f99a79
david@davids:~/git/puppetlabs-panos$
That got me thinking, and now there is a bugfix at https://github.com/puppetlabs/puppet-resource_api/pull/247/ .
I can reproduce 2641 using the rcsrepo example. Maybe there is difference in behavior with single vs multiline description/summaries?
fix was merged in https://github.com/puppetlabs/puppet-resource_api/pull/247