> I did say we needed more docs effort
Yes, where should the docs for this go? The Alter table reference page,or Chapter 5.5 titled "Modifying Tables"?