API explicit joins: Fix markdown in ordered list and a few copy edits

I noticed that in the published version the ordered list is displaying as a jumbled paragraph instead of a list. Hopefully this fixes it.