Improve pipeline documentation with clearer structure and practical examples (#350)

* Initial plan

* Improve pipeline documentation with clearer explanations and examples

Co-authored-by: nijel <[email protected]>

* Address code review feedback - improve example code safety and clarity

Co-authored-by: nijel <[email protected]>

* Address code review feedback: use Sphinx directives and remove duplication

Co-authored-by: nijel <[email protected]>

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: nijel <[email protected]>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: 3 people