doc(standard): deprecate usedBy

[bfabio]

No description provided.

[bzg]

Hi Fabio, I probably missed some previous conversation about this: why is usedBy deprecated? This is something we use in https://github.com/codegouvfr/awesome-codegouvfr/ and this is a useful information we want to promote. Is it replaced by something else?

Copying my colleague @hjonin on this.

[bfabio]

Hi @bzg, it's a proposal that has been cooking for a while now because usedBy comes with many pitfalls. I marked it as a draft while I'm writing the rationale and the various thoughts we've had over the years, so we can have a single place with all feedback we gathered.

It's not final of course, there's still the discussion and voting to be had.

While we're at it, I think we can try and vote the proposals for v0.3.1 of the Standard this month (leaving this one out if there's no clear consensus).

[bvhme]

I saw the usedBy also used in the prototype JoinUp catalogue. I like it, but understand there are some pitfalls with a key like this and that it might not completely fit the concept of the standard.

[libremente]

I saw the usedBy also used in the prototype JoinUp catalogue. I like it, but understand there are some pitfalls with a key like this and that it might not completely fit the concept of the standard.

Do you have any idea on how that field is used in that context? Just curiosity

[libremente]

I saw the usedBy also used in the prototype JoinUp catalogue. I like it, but understand there are some pitfalls with a key like this and that it might not completely fit the concept of the standard.

Since the EU catalogue is now live I can see that they are displaying the usedBy entry at the bottom of the page. Unfortunately, as of today, the catalogue's code has not been released anywhere so I have no idea how they implemented this feature but checking a few entries in the catalogue it looks consistent (i.e., if that array is populated then its entries are displayed in the webpage or in a modal window if the list is too long).

[bzg]

FWIW we are still reading usedBy entries from publiccode.yml files when displaying the Awesome code.gouv.fr list.

We could replace it with a new property instances as an optional array of URLs to list public instances.

Do you think instances (or equivalent) would be of interest?