WIP: API Doc

more questions on time format below