add auth section; restructured API reference; removed many draft comments