tweaked and added more pro-documentation points

Hi @BillMills, cleaned up the article a bit with minor tweaks.