Layout specification and discovery should follow the same behavior as partials

Fixes #1047
nit: use `<inheritdoc/>` rather than repeating the `<param/>` descriptions (`<inheritdoc/>` only merges in what is not already on the member)