It would be great if NatSpec @notice, @param and @dev comments on structs and enums would be available in the documentation.
For example, having
/// @notice Text.
/// @param a Text 1.
/// @param b Text 2.
struct ProposalParameters {
bool a;
uint256 b;
}
and documenting it with
{{natspec.notice}}
{{#if natspec.params}}
| Member | Type | Description |
|:------ | ---- | ----------- |
{{#each params}}
| {{name}} | {{type}} | {{natspec}} |
{{/each}}
{{/if}}
I am aware of #413, but still unsure if this is possible by now or not because of insufficiencies of the solidity compiler.