How about changing the document system so we can type the comment within the sub, marked with a Doc tag, rather than before it.
like this
like this
B4X:
Sub SomeMethod
'<Doc>
'This is comments for some method
'<b>This text is Bold</b>
'<code>Dim i as int</code>
'</Doc>
'This is general comment, not shown in tooltips.
End Sub