@Tak I'll never get over how dumb it looks to use XML for doc comments.
Or, well, in general.
But particularly for stuff that should be also human-readable in its non-HTML-rendered form.

@silverweed Is it substantially different than doxygen or javadoc in that respect? 🤷

@Tak Well, personally I find those a little less noisy.
I admit I speak as a doc comment reader much more than a writer (when I write doc comments I always only use plain text), but I find doc styles based on "lighter" markup (e.g markdown-like) much more readable

Sign in to participate in the conversation
Gamedev Mastodon

The social network of the future: No ads, no corporate surveillance, ethical design, and decentralization! Own your data with Mastodon!