docs(contributing): expand contribution guidelines with new sections

[mohammedfirdouss]

• Expand contributing.md with community, dev setup, and PR process
• Rename "Contributing" to "Contribute to PipeCD"
• Apply changes to docs-dev and docs-v1.0.x

Addresses #6124

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[eeshaanSA]

Hey, thanks for this @mohammedfirdouss!

I checked the files, and while they look good, what do you think of making some more structural changes (better flow of data and sections), and also some more info on how to setup the a local dev guide? The reference to CONTRIBUTING.md is fine, but the CONTRIBUTING.md itself is outdated, so it is better to just have all the information in one page on the website.

[mohammedfirdouss]

Hey, thanks for this @mohammedfirdouss!

I checked the files, and while they look good, what do you think of making some more structural changes (better flow of data and sections), and also some more info on how to setup the a local dev guide? The reference to CONTRIBUTING.md is fine, but the CONTRIBUTING.md itself is outdated, so it is better to just have all the information in one page on the website.

Thanks for the feedback @eeshan! Hmm, Okay the website docs page should be self-contained rather than referencing CONTRIBUTING.md.

TO-DO

• Better structured sections with clear flow
• Complete local dev setup guide inline (Control Plane, Piped agent, port-forwarding, etc.)
• Full PR process details instead of just linking to CONTRIBUTING.md

@eeshaanSA This should address the issue already yeah? I am open to feedbacks

[eeshaanSA]

LGTM, @mohammedfirdouss.

Thanks a lot for your contributions! 🚀

[mohammedfirdouss]

LGTM, @mohammedfirdouss.

Thanks a lot for your contributions! 🚀

Thank you for the reviews as well @eeshaanSA. Ready for more contributions!

[eeshaanSA]

We can also change the file names to contributing-to-pipecd.md or something similar. contributing.md looks vague.

[mohammedfirdouss]

Hmm, this should be straightforward like you say but i feel the naming might be to long

[eeshaanSA]

Yes, you are right, but it is better to keep things clear, because we might need more pages here in the future.

[mohammedfirdouss]

No problem, i have made a change to this effect.

[eeshaanSA]

I might be nitpicking, but @mohammedfirdouss, what do you think about 'Join the Community' section being repositioned somewhere at the bottom? Would love to know your thoughts!

[mohammedfirdouss]

That makes sense to me. Moving Join the Community to the bottom should focus on how to contribute first, and people can find community links after.

[eeshaanSA]

We can move "Join the Community"before "Whats next, in my opinion, and,

you changed only the docs-dev file. You forgot about v1.

[mohammedfirdouss]

We can move "Join the Community"before "Whats next, in my opinion, and,

you changed only the docs-dev file. You forgot about v1.

They should have similar structure now @eeshaanSA

[eeshaanSA]

Hey @mohammedfirdouss, maybe you misunderstood the placement of Join the Community. Let's place it at the bottom end for both the files.

[mohammedfirdouss]

Ohh!,apologies for that @eeshaanSA. Thanks!

[eeshaanSA]

I think everything looks good now, @mohammedfirdouss. Thanks!

Let the maintainers merge, and then if we find anything later, we can change it.

[mohammedfirdouss]

I think everything looks good now, @mohammedfirdouss. Thanks!

Let the maintainers merge, and then if we find anything later, we can change it.

Alright @eeshaanSA. Thanks for the reviews!

[mohammedfirdouss]

@eeshaanSA In the meeting, Khan said I should rename the files, so docs/content/en/docs-dev/contribution-guidelines/contributing.md retains its name and the other goes to docs/content/en/docs-v1.0.x/contribution-guidelines/contributing-to-pipecd.md