Improvements for Kubeflow Pipelines documentation

[hbelmiro]

• Add content to the Kubeflow Pipelines V2 installation page #3714
• Improve KFP backend and installation instructions #3729
• Document that is possible to upload a .zip or .tar.gz file as a pipeline #3715
• Review the structure of the docs to reflect Kubeflow 1.9 #3716

[StefanoFioravanzo]

@hbelmiro can you please elaborate on the third bullet? Do you have something specific in mind?

[hbelmiro]

@hbelmiro can you please elaborate on the third bullet? Do you have something specific in mind?

@StefanoFioravanzo Done.

[StefanoFioravanzo]

@hbelmiro @diegolovison Hey, I'd like to draw your attention to these two comments:

• Improve docs for Training Operator 1.8 training-operator#1998 (comment)
• Documentation Improvements for Katib 0.17 katib#2314 (comment)

and then the Katib PR that addresses those comments:

• Katib: Reorganized Katib Docs #3723

As you can see, I am proposing a restructuring based on principles that we can apply for KFP as well. Would either one of you take the lead and propose a similar restructuring for the KFP docs? It would be great to start with a proposal similar to what I did for Katib, outlining what needs to change, what needs to move, what new sections we need. As you go through this exercise, you can also take note of what user guides or topics are missing, and share a separate list of TODOs.

We can track this here #3716 if you want. Whatever suits you better. Let me know your thoughts!

PS: My thought process follows this doc framework https://diataxis.fr/ - I encourage you to take ~1h and go through it. It's very well written and easy to follow. It won't take long!

[hbelmiro]

@StefanoFioravanzo I really like the idea. It will enhance the documentation's quality and keep consistency between the components. We could also mention that structure in https://www.kubeflow.org/docs/about/style-guide/.

Would either one of you take the lead and propose a similar restructuring for the KFP docs?

Yes, I can do it.

We can track this here #3716 if you want. Whatever suits you better. Let me know your thoughts!

Yeah, sounds good.

[StefanoFioravanzo]

@hbelmiro Can you link this in the first comment? #3729

[hbelmiro]

@StefanoFioravanzo I added as a new bullet since it can be done in a follow-up PR.