The Help document should show ordered lists using the _same_ number


#1

Hi

First time poster, just getting into git, github, md, and all the thingz.

Wanted to say wonderful tutorial. I learned a lot, especially about images:
you're awesome

However I think that the Help document should show ordered lists as the same number.

The Help doc shows ordered list like:
1. one
2. two
3. three

I think the true power of MD is the fact that you can use any number. So the examples could be improved to show this. Help doc could be changed to:
1. one
1. two
1. three


#2

Markdown offers a number of shortcuts, but often these shortcuts are less readable. The longer approach instills a good habit by encouraging markup that looks closer to the output.


#3

I somewhat agree, but it’s useful when you need to insert another another entry between two entries (updating documentation, perhaps). This could also manifest when some one removes an entry. Now the markdown numbers won’t match the HTML numbers.

Consider before:
1. one
2. two
3. three

After
1. one
2. two
2. two B
3. three

Or, after
1. one
2. two
3. three

(messy)

This is easier to manage:
1. one
1. two
1. two B
1. three

and:
1. one
1. three


#4

Ideally you would go through and update the numbers manually. In long lists this can be time consuming, but that’s the cost of readability. For shorter lists (say, 10 items) it’s not a huge problem to update the numbers manually.