There's a new inline comment help. That's great. It also explains who will be notified of comments. That's great too. But the wording doesn't clearly exclude a common newbie mistake: it's not apparent that only one person can be @notified. Here's a proposed improvement:
Comments use mini-Markdown formatting: [link](http://example.com) _italic_ **bold** `code`
. The post author will automatically be notified of your comment. To notify a previous commenter (just one), mention their user name: @peter
or @PeterSmith
will both work.
(Added “(just one)”)
... will both work
" still reads ambiguous. It should be "either @peter or @PeterSmith will function.
" or something like that. It requires less cognitive effort to parse the sentence if the "both" is gone. (Which I assume is the origin of the misunderstanding.)