> I agree on both counts. I just like to read these in plain text > while I am coding for Git (or reviewing patches coded for Git). > > The reason why I have mild preference to D/technical/ over in-header > doc is only because I find even these asterisks at the left-side-end > distracting; it is not that materials in D/technical could be passed > through AsciiDoc. /** Would we be open to consider another commenting style? AFAICT the asterisks are a cultural thing and not enforced by and old compiler not understanding these comments. Just like ending the comment in an asymetric fashion ;-) */ (I am not seriously proposing unbalanced comments, but for longer documenting comments we may want to consider, omitting the asterisk?)