FWIW, Verdana aligns those asterisks just fine. I do think deleting those asteri... | Hacker News

Hacker Newsnew | past | comments | ask | show | jobs | submit

		GoblinSlayer on Feb 15, 2022 \| parent \| context \| favorite \| on: MonoLisa – A font designed for developers FWIW, Verdana aligns those asterisks just fine. I do think deleting those asterisks makes documentation better and I personally write documentation without asterisks. Why they are there at all? It's just noise.

ryanbrunner on Feb 15, 2022 [–]

It's a documentation standard that is used by various tools, if you're utilizing those tools you don't really have an option.

GoblinSlayer on Feb 15, 2022 | [–]

https://docs.oracle.com/javase/1.5.0/docs/tooldocs/windows/j... - this standard? It clearly states you have options. Doxygen does the same.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact