Skip to main content
Super User

You are not logged in. Your edit will be placed in a queue until it is peer reviewed.

We welcome edits that make the post easier to understand and more valuable for readers. Because community members review edits, please try to make the post substantially better than how you found it, for example, by fixing grammar or adding additional resources and hyperlinks.

3
  • Markdown formatting exists for a reason: if steps are chronological, a number list should be used; bulleted lists are used when explaining details specific to the preceding step or paragraph. Grammatically, sentences shouldn't be split by code boxes since it discombobulates the content. For these reasons, I downvoted this answer and will remove it when the markdown formatting issues are resolved (it doesn't need to be like my edit, as edits are merely a suggestion for the author, however there are markdown issues to be resolved)
    – JW0914
    Commented May 31, 2022 at 13:28
  • 2
    @JW0914 Please keep in mind that markdown and HTML semantics have a purpose. You should never use single-bullets to indicate a call-out. Bullets are list items and should be used as such. Not doing so is confusing to screen reader software, at the very least. As such, I reverted your edits since they made the answer less readable. Also, numbered lists aren't needed for every flow. Answers are typically chronological in nature, and the paragraph flow is more readable unless short list items are needed. In that case, I would agree it is preferable to use a numbered list.
    – NotTheDr01ds
    Commented May 31, 2022 at 13:36
  • I have a different perspective due to the amount of complex, in-depth answers I've written (example 1, example 2, example 3, example 4, etc.). As previously stated, "...it doesn't need to be like my edit, as edits are merely a suggestion for the author,", however when lined up side-by-side, I disagree this answer in its current form is more readable.
    – JW0914
    Commented May 31, 2022 at 13:54