Move (and update) Pipelines pages from Legacy (v1) to Pipelines root

[hbelmiro]

There are also a few pages in the "Legacy (v1)" section which will need updating but are critical to move/copy.

Here is the list of "Legacy (v1)" pages which we need to move to top of "user guides":

• Introduction to the Pipelines SDK
  • Once updated, It can go to the top of the "User Guides" section.
• Install the Kubeflow Pipelines SDK
  • This is just explaining how to pip install kfp and use a conda env, we can update it and put it second under the "User Guides" section.

Here is the list of "Legacy (v1)" pages which we need to move to the "user guides" under "core functions":

• Pipeline Parameters
• Visualize Results in the Pipelines UI
  • This one is critical, because it currently includes V2 docs under a separate heading, despite living in the V1 section.

Here is the list of "Legacy (v1)" pages which we need to move to the "user guides" under "create components":

• Building Components
• Best Practices for Designing Components

Contextualization: #3737 (review)

This must be done after #3737 gets merged.

[thesuperzapper]

@hbelmiro We also need to create a V2 version of "Manipulate Kubernetes Resources as Part of a Pipeline".

Its quite different in V2 as it uses the kfp[kubernetes] library:

• https://kfp-kubernetes.readthedocs.io/en/kfp-kubernetes-1.0.0/source/kubernetes.html
• https://github.com/kubeflow/pipelines/tree/master/kubernetes_platform/python

I also note that there seem to be a few significant features missing (namely the ability to manipulate arbitrary resources, like the old v1 ResourceOp):

• [bug] KFP V2 does not support Volumes pipelines#8570
• [feature] Continued support for resourceOp / custom resource definitions pipelines#9703
• [feature/idea] Integrate kubernetes's models into kfp-kubernetes pipelines#9768

We could suggest people use a Python component with the kubernetes python library, but that should be a decision for the @kubeflow/pipelines leads.

[hbelmiro]

/area pipelines