up: removed pipeline comments and created docs/pipeline_notes.md for clear guidance See merge request !25