document how pipeline's work