update general api docs, merge with formats doc