search

Deleplace / programming-idioms

A collection of good snippets, in a lot of languages
Apache License 2.0
128 stars 8 forks source link

[BUG] Perl6 code examples should be removed from Perl #218

Open jgpuckering opened 1 year ago

jgpuckering commented 1 year ago

I’ve been going through the Perl code idioms, filling in many that were missing, when I noticed that there are some that are specific to Perl 6 — which is now named Raku and which is a different language than Perl 5. See idiom #50 for an example.

Perl 5 and Perl6/Raku have officially diverged are now going their separate ways. Having Perl 6 code intermixed with Perl 5 examples is confusing.

Perhaps there should be a language entry for Raku and the Perl 6 code examples relocated.

At a minimum the Perl 6 code examples under Perl should be removed.

Deleplace commented 1 year ago

Hi Gary, thank you so much for all your recent contributions.

Yes I agree, any snippet specific to Perl6/Raku is not appropriate as a "Perl" entry, and should be fixed (jump back to Perl5 compat) or deleted.

If you know how to modify them directly to match Perl5, please do so.

If you can help me with a list of implementation IDs to be deleted, I will be happy as an Admin to delete them.

Sometimes an Idiom has multiple implementations for the same language, which is why it's important to find the specific implementation ID to be deleted (e.g. by clicking on the impl language name near the idiom title) image

jgpuckering commented 1 year ago

Hi Valentin!

Sure, I'd be happy to fix the Perl 6 code and identify things that should be removed.

This site was a cool idea. I've had fun filling in the gaps. As a retired software engineer I take on projects like this to keep my brain working. It's surprising how tricky some of these are, especially with a language like Perl -- whose philosophy is "there's more than one way to do anything".

Do you have any recommendations for a free platform to put code demos? (I noticed some of them don't work.)

One thing that would be nice is a way to filter the Language Coverage list so that only the empty entries are shown. Or to sort the column.

How are the columns sorted, by the way? Not by id or idiom title, that's for sure!

Regards,

Gary

Hi Gary, thank you so much for all your recent contributions.

Yes I agree, any snippet specific to Perl6/Raku is not appropriate as a "Perl" entry, and should be fixed (jump back to Perl5 compat) or deleted.

If you know how to modify them directly to match Perl5, please do so.

If you can help me with a list of implementation IDs to be deleted, I will be happy as an Admin to delete them.

Sometimes an Idiom has multiple implementations for the same language, which is why it's important to find the specific implementation ID to be deleted (e.g. by clicking on the impl language name near the idiom title) [image]https://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fuser-images.githubusercontent.com%2F13508141%2F198904586-842ff171-cb85-42af-a081-53e331ff0ecf.png&data=05%7C01%7C%7C6fad1302a564420a8b1d08dabac616e7%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638027657193735981%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=%2FJpgAlfz0FaLrfM5XBG1zZ%2Fs3zEPhz%2B4BVeTjBo%2B6Ds%3D&reserved=0

— Reply to this email directly, view it on GitHubhttps://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDeleplace%2Fprogramming-idioms%2Fissues%2F218%23issuecomment-1296365525&data=05%7C01%7C%7C6fad1302a564420a8b1d08dabac616e7%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638027657193735981%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=rSsE03ZhRnNSPpsYGj%2FCPNxNbsKOing05AeaWM981qw%3D&reserved=0, or unsubscribehttps://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fnotifications%2Funsubscribe-auth%2FABKV26DOOPAWH7VAVQAC4P3WF3SAJANCNFSM6AAAAAARSM5JGI&data=05%7C01%7C%7C6fad1302a564420a8b1d08dabac616e7%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638027657193735981%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=na2RU3qxVrO9v9Qk%2FsLtNIbevh4QTP9wDk0lbtnHIZU%3D&reserved=0. You are receiving this because you authored the thread.Message ID: @.***>

Deleplace commented 1 year ago

When there's more than one way to do it, and they are all acceptable, then we can have several of them, no problem. The visitor will read them, maybe test them, and figure out which one best fits their needs.

codepad.org is really cool and simple, however

The alternative wandbox.org is really cool too! I recommend it.

To discover missing entries, as a contributor: have a look at the Perl Backlog. It shows a random sample of things to complete, different when you refresh.

The Language Coverage page shows first the columns of your "favorite languages", in green. In the subsequent columns, the languages are sorted by completeness: 1 point for an snippet, 1 point for a doc link, 1 point for a demo link.

I agree with the sentiment "some simple things are tricky to implement" - and also it takes times! Often more than 15mn for a correct implementation, with documentation, and with a runnable demo.

jgpuckering commented 1 year ago

No kidding! I think I spent a couple of hours today on idioms where bytes and characters were involved!

When there's more than one way to do it, and they are all acceptable, then we can have several of them, no problem. The visitor will read them, maybe test them, and figure out which one best fits their needs.

codepad.orghttps://nam12.safelinks.protection.outlook.com/?url=http%3A%2F%2Fcodepad.org%2F&data=05%7C01%7C%7Cd96abaaa9f5e48aed23f08dabad0edb5%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638027703743711261%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=AOKdZQfgIQXKxi5s8JuVpCrztR2%2FnJmRsWSu7mylJCQ%3D&reserved=0 is really cool and simple, however

The alternative wandbox.orghttps://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwandbox.org%2F&data=05%7C01%7C%7Cd96abaaa9f5e48aed23f08dabad0edb5%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638027703743711261%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=T%2FQVVQMavAW9GLlGdaJAjYkfJ5lMXUHCICDOd6IQrjs%3D&reserved=0 is really cool too! I recommend it.

To discover missing entries, as a contributor: have a look at the Perl Backloghttps://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fprogramming-idioms.org%2Fbacklog%2FPerl&data=05%7C01%7C%7Cd96abaaa9f5e48aed23f08dabad0edb5%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638027703743711261%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=xMJiLyq%2B2Xnp6cbkaEzIKPDkhL8hdhjjwUCcmT94K6w%3D&reserved=0. It shows a random sample of things to complete, different when you refresh.

The Language Coverage page shows first the columns of your "favorite languages", in green. In the subsequent columns, the languages are sorted by completeness: 1 point for an snippet, 1 point for a doc link, 1 point for a demo link.

I agree with the sentiment "some simple things are tricky to implement" - and also it takes times! Often more than 15mn for a correct implementation, with documentation, and with a runnable demo.

— Reply to this email directly, view it on GitHubhttps://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDeleplace%2Fprogramming-idioms%2Fissues%2F218%23issuecomment-1296381328&data=05%7C01%7C%7Cd96abaaa9f5e48aed23f08dabad0edb5%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638027703743711261%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=3KnYCFccy78gqFsrOtOUViRaIHdtZjqS6D3gT4vTQRE%3D&reserved=0, or unsubscribehttps://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fnotifications%2Funsubscribe-auth%2FABKV26A7KNHWYXCY26YUM43WF33DJANCNFSM6AAAAAARSM5JGI&data=05%7C01%7C%7Cd96abaaa9f5e48aed23f08dabad0edb5%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638027703743711261%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=%2Bd%2FvU80mGb5bnBoKICZwCpJOLHoB%2BxGvPm775hsicYY%3D&reserved=0. You are receiving this because you authored the thread.Message ID: @.***>

jgpuckering commented 1 year ago

Question: what does clicking the Flag button do? And is that documented anywhere?

Deleplace commented 1 year ago

It's "flagging" in the sense of "reporting a problem".

If you see something very unambiguously fixable (e.g. a typo), the best is to fix it by editing the implementation entry.

If you think the snippet is okay but there's a better way to achieve the goal, the best is to create a new distinct entry (not to overwrite the existing suboptimal one).

If you see something plain wrong and can't fix it, you click the Flag button, explain why, and I (the admin) will see what we can do with it. Often the correct action is will be to delete the entry, and only an admin can do that.

Le lun. 31 oct. 2022 à 16:56, Gary Puckering @.***> a écrit :

Question: what does clicking the Flag button do? And is that documented anywhere?

— Reply to this email directly, view it on GitHub https://github.com/Deleplace/programming-idioms/issues/218#issuecomment-1297306570, or unsubscribe https://github.com/notifications/unsubscribe-auth/ADHB4LPQLI4H7YV2JI3PNNLWF7T2XANCNFSM6AAAAAARSM5JGI . You are receiving this because you were assigned.Message ID: @.***>