So the docs are really not where I want them to be on this one. We've been waiting for the Viz work to catch up since it makes the whole concept much easier to articulate, we also need a new version of the spaceflights tutorial that takes advantage of the functionality. What I would encourage you to do is run

kedro pipeline create <pipeline_name>

in a new project to see the folder structure in action. The clever part is articulated in this example:

python
final_pipeline = Pipeline(
    [
        pipeline(cook_pipeline, outputs={"grilled_meat": "new_name"}),
        pipeline(lunch_pipeline, inputs={"food": "new_name"}),
        node(...),
        ...,
    ]
)

Both

cook_pipeline

and

lunch_pipeline

are existing modular pipeline, but by using the

pipeline

method (not class) you are able to create an instance of them where you can swap catalog inputs/outputs for them