docs: rename platforms to clientPlatforms and update examples

[rantoniuk]

#221

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Project	Deployment	Preview	Comments	Updated (UTC)
publiccode-yml	✅ Ready	Preview	Comment	Aug 12, 2025 4:28pm

[bfabio]

Why is this garbage Copilot bot commenting on PRs?

[rantoniuk]

@https://github.com/apps/copilot-pull-request-reviewer Copilot AI review requested due to automatic review settings

[bfabio]

@rantoniuk thanks for the PR!

FYI, changing the name would be a breaking change, and breaking changes need to go through a process of deprecating the thing first: see https://github.com/publiccodeyml/publiccode.yml/blob/main/governance/procedure-proposing-changes-and-voting.md

Anyway, I don't think changing the name would be necessary, as we can make clear what that key is about by improving its description. The description, on the other hand, badly needs to be improved because right now it is pretty cloudy, and I think it's because the meaning of the key itself is pretty cloudy :)

I'd like to discuss and have a consensus on what this key is supposed to achieve on #221 before

[rantoniuk]

I'd like to discuss and have a consensus on what this key is supposed to achieve on #221 before

Didn't we already discuss and agree?

[bfabio]

I'd like to discuss and have a consensus on what this key is supposed to achieve on #221 before

Didn't we already discuss and agree?

I haven't really shared my thoughts yet. I have something else in mind, let me write that down in the issue.