Currently, the behaviour of blocks is a bit strange:
When outputting RBI, blocks are always required.
When outputting RBS, blocks are always optional.
This inconsistency isn't intuitive and could lead to some confusion, especially when targeting multiple output types. I think required should be the default across both output types, and that you should be able to change it to optional if you want.
I don't believe YARD has a way of specifying if a block is optional or required, so we'd have to hijack an existing tag somehow, like using the word "Optional" at the beginning of @yield to indicate that it's optional for that method.
Currently, the behaviour of blocks is a bit strange:
This inconsistency isn't intuitive and could lead to some confusion, especially when targeting multiple output types. I think required should be the default across both output types, and that you should be able to change it to optional if you want.
I don't believe YARD has a way of specifying if a block is optional or required, so we'd have to hijack an existing tag somehow, like using the word "Optional" at the beginning of
@yield
to indicate that it's optional for that method.