fix tag order
improve api tests
add doc