It should probably stay. It is more readable. Still, the API guide has other things that are better suited for online documentation (such as 2 spaces instead of tabs to avoid horizontal scrollbars). So I guess all the guides don't need to agree. In this particular case, I suppose it's best for core to adopt UI's guide.