document and clarify test cases for pipeline