you are right, we should write some doc on it