[Simran-B]

I don't like Asciidoc's ordered lists.

. Foo

. Bar

. Baz

Markdown is more intuitive to understand, and the idea is that it's human readable even if not rendered.

1. Foo

2. Bar

3. Baz

I'm not a fan of using 1. for each bullet point, as that takes away from the "readable source code" paradigm. On the other hand, it avoids a change in indentation if you have ten or more items.