port over the changes to the markdown docs