docs: describe workflow rationale

[deliaBlue]

This PR closes #126.

The changes applied are:

• Correct file extensions, typos, explanations and add examples in some rules in the pipeline_documentation.md
• Expand the workflow description and fix typos in the main README.

[uniqueg]

Couple of issues, but shouldn't take long to fix. Didn't look at all of the many changes in the pipeline documentation file carefully - but it looks mostly fine :)

To be fair, it's probably one of the 10 most detailed pipeline documentations ever written 🤣

[uniqueg]

Oh, and please check why the static code analysis fails.

[uniqueg]

Please address the open comments and send for re-review when you are done 🙏

[uniqueg]

@deliaBlue: Somehow this PR showed up in my GitHub notifications, probably because you added commits? Is there anything I should do at this point? Or am I still waiting until you resolve the open conversations and tell me to review? :)

[deliaBlue]

@deliaBlue: Somehow this PR showed up in my GitHub notifications, probably because you added commits? Is there anything I should do at this point? Or am I still waiting until you resolve the open conversations and tell me to review? :)

Righr now this PR lacks the documentation of the recently-merged PRs. Also, the unsolved comments are halfway through. We discussed them a while ago but leave the PR for when the other PRs were merged due to the different style in the documentation. As soon as it is done, I will ask you to review it :)

[uniqueg]

This looks great! :)