Moving some API comments from 1.0-snapshot to develop