referencing external data sources in PSRs

[Lukas Kahwe Smith]

Hello,

while reviewing PSR-11 I noticed that it includes some links to external websites and images that denote download rates. imho its not ideal to do this. or at least where-ever this is done there should be a snapshot of the data should be included.

The rational being that these external data sources can go away and also as time passes the data there will change, which in turn will make it harder to understand the context in which this decision was originally made.

Note this isn't a huge deal and I assume will simply remain as is for PSR-11 but imho it should think about a best practice to handle future cases. I guess in the past we collected such statistics in emails to this list that then got referenced in the PSR ..?

regards,
Lukas Kahwe Smith
sm...@pooteeweet.org

[Stefano Torresi]

I agree 100%.
I'd also add we shouldn't give download numbers this much relevance in the first place, and that it kinda shows some sort of confirmation bias going on, which we don't really need: the proposal can stand on its own merits.

If nobody objects, I'll wrap a PR up to simplify and finalize this list in the metadoc.

--
You received this message because you are subscribed to the Google Groups "PHP Framework Interoperability Group" group.
To unsubscribe from this group and stop receiving emails from it, send an email to php-fig+u...@googlegroups.com.
To post to this group, send email to php...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/php-fig/F7B6B1D0-E3E3-42FA-9D96-01C576DAF78B%40pooteeweet.org.
For more options, visit https://groups.google.com/d/optout.