10

The "comment everywhere" privilege documentation refers to the "add a comment" link using code formatting.

This may mislead people into thinking that code formatting should be used for English quotes, proper nouns and the like, in their posts. It shouldn't. This is already a problem that gets edited out of a lot of SE posts.

Can we fix it in the documentation?


Screenshot of the problem with a nice freehand red circle

2
  • What would you replace it with?
    – Mast
    Commented Nov 14, 2019 at 14:38
  • @Mast I dunno - quotation marks should be fine? There's an example in my post. Commented Nov 14, 2019 at 14:39

2 Answers 2

3

Thank you for noticing the error. I edited the article. Now the phrase formatted as a quote, not as a code.

0
4

The help does say: "inline `code in backticks`", so it should follow that example advice when writing the Help. Thus the documentation for "How do I comment?" should instead be:


Click the "add a comment" link under each post. Comments cannot be multi-line, so simply press enter to submit your comment.

Note that comments support a small subset of Markdown, so you can do things like: _italic_, **bold**, ***bold_italic***, [chat], [edit], [help/on-topic], [tag:tagname], [meta-tag:tagname], and [named hyperlinks](https://example.com).


That might offend some HTML purists to have a non-clickable link, but it's literal.
That took a bit of coding to get it to look correct using the limited Markdown.

3
  • Code formatting for the Markdown samples seems appropriate, just not for quoting a piece of link text. Commented Nov 14, 2019 at 15:31
  • Mm, could be. Link styling on SE is very inconsistent. Commented Nov 14, 2019 at 16:07
  • LightnessRaceswithMonica, I swapped out the Markdown as you suggested and expanded the example to include a short list of what seems to be the most frequently used shorthand links.
    – Rob
    Commented Nov 14, 2019 at 17:16

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .