Skip to main content
Tweeted twitter.com/AskUbuntu/status/1000414566436745216
Clarify rationale and emphasize question is about markdown syntax / style guide best practices, and not about the answer I posted that led to this question.
Source Link

I noticed my answer to a question was subsequently revised and approved for no apparent reason other than markdown preference.

Question

However, it led me to wonder whatWhat is the preferred formatting of an ordered list using markdown? I can't find a style guide for a preference for numbered lists: in the A: Style guide for questions and answersStyle Guide for questions and answers. On a "Stack site" like this that uses markdown syntax that doesn't care, it might seem nitpicky. But also considering syntax wasn't targeted for community revisions, should a best practice be defined?

I didn't edit the Style Guide as its unclear to me how to build consensus, so I posted this question. It's also not clear to me if more appropriate that changes should be made on the formatting help page?

DetailsBackground Rationale

In my original post I used a placeholdernonordinal number (0.) for order, intentionally not defining index. The edit changed placeholders in favor of pre-numbered of itemsordinal numbers (1., 2., ... N.) to define a preset sequencean index.

Although it is syntactically correct, itwhen edited, using ordinal numbering seems less flexible or clear (in a diff) if edited,; creating a cascading change effect.

I noticed my answer to a question was subsequently revised for no apparent reason than markdown preference.

However, it led me to wonder what is the preferred formatting of an ordered list using markdown? I can't find a style guide for a preference for numbered lists: A: Style guide for questions and answers.

Details

In my original post I used a placeholder number (0.) for order. The edit changed placeholders in favor of pre-numbered of items (1., 2., ... N.) to define a preset sequence.

Although it is syntactically correct, it seems less flexible or clear (in a diff) if edited, creating a cascading change effect.

I noticed my answer to a question was revised and approved for no apparent reason other than markdown preference.

Question

What is the preferred formatting of an ordered list using markdown? I can't find a preference for numbered lists in the Style Guide for questions and answers. On a "Stack site" like this that uses markdown syntax that doesn't care, it might seem nitpicky. But also considering syntax wasn't targeted for community revisions, should a best practice be defined?

I didn't edit the Style Guide as its unclear to me how to build consensus, so I posted this question. It's also not clear to me if more appropriate that changes should be made on the formatting help page?

Background Rationale

In my original post I used a nonordinal number (0.), intentionally not defining index. The edit changed placeholders in favor ordinal numbers (1., 2., ... N.) to define an index.

Although it is syntactically correct, when edited, using ordinal numbering seems less flexible or clear (in a diff); creating a cascading change effect.

Add details for clarity
Source Link

I noticed my answer to a question was subsequently revised for no otherapparent reason than using markdown per syntax. It seems to me pre-numbering items to define a sequence is syntactically correct, but less flexible or clear (in a diff) if editedpreference.

However, it led me to wonder what is the preferred formatting of an ordered list using markdown? I can't find a style guide for a preference for numbered lists: A: Style guide for questions and answers.

Details

In my original post I used a placeholder number (0.) for order. The edit changed placeholders in favor of pre-numbered of items (1., 2., ... N.) to define a preset sequence.

Although it is syntactically correct, it seems less flexible or clear (in a diff) if edited, creating a cascading change effect.

I noticed my answer to a question was subsequently revised for no other reason than using markdown per syntax. It seems to me pre-numbering items to define a sequence is syntactically correct, but less flexible or clear (in a diff) if edited.

However, it led me to wonder what is the preferred formatting of an ordered list using markdown? I can't find a style guide for a preference for numbered lists: A: Style guide for questions and answers.

I noticed my answer to a question was subsequently revised for no apparent reason than markdown preference.

However, it led me to wonder what is the preferred formatting of an ordered list using markdown? I can't find a style guide for a preference for numbered lists: A: Style guide for questions and answers.

Details

In my original post I used a placeholder number (0.) for order. The edit changed placeholders in favor of pre-numbered of items (1., 2., ... N.) to define a preset sequence.

Although it is syntactically correct, it seems less flexible or clear (in a diff) if edited, creating a cascading change effect.

Source Link

What is the preferred way to add a numbered list using markdown?

I noticed my answer to a question was subsequently revised for no other reason than using markdown per syntax. It seems to me pre-numbering items to define a sequence is syntactically correct, but less flexible or clear (in a diff) if edited.

However, it led me to wonder what is the preferred formatting of an ordered list using markdown? I can't find a style guide for a preference for numbered lists: A: Style guide for questions and answers.