hemanth / functional-programming-jargon

Jargon from the functional programming world in simple terms!
http://git.io/fp-jargons
MIT License
18.59k stars 1.02k forks source link

Writing style #108

Closed idf closed 8 years ago

idf commented 8 years ago

In Higher-Order Function,

const filter = (pred, xs) => ...

For this one, is it better to explicitly use predicate rather than pred? Because the former one is more explicit, and for documentation we tend to favor explicit.

MichalZalecki commented 8 years ago

I think it's like arr and array. It's so obvious that people just get that without much thinking.

28.08.2016 00:15 "Daniel D. Zhang" notifications@github.com napisał(a):

In Higher-Order Function,

const filter = (pred, xs) => ...

For this one, is it better to explicitly use predicate rather than pred? Because the former one is more explicit, and for documentation we tend to favor explicit.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/hemanth/functional-programming-jargon/issues/108, or mute the thread https://github.com/notifications/unsubscribe-auth/AC_cQVUN8XISdryIqSRAtLuvwSsFMW5Qks5qkLbygaJpZM4Juy9Z .

jethrolarson commented 8 years ago

I'm okay with using the full word if it helps people. Non fp people often don't know what a predicate is anyway.

On Sat, Aug 27, 2016, 3:45 PM Michał Załęcki notifications@github.com wrote:

I think it's like arr and array. It's so obvious that people just get that without much thinking.

28.08.2016 00:15 "Daniel D. Zhang" notifications@github.com napisał(a):

In Higher-Order Function,

const filter = (pred, xs) => ...

For this one, is it better to explicitly use predicate rather than pred? Because the former one is more explicit, and for documentation we tend to favor explicit.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/hemanth/functional-programming-jargon/issues/108, or mute the thread < https://github.com/notifications/unsubscribe-auth/AC_cQVUN8XISdryIqSRAtLuvwSsFMW5Qks5qkLbygaJpZM4Juy9Z

.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/hemanth/functional-programming-jargon/issues/108#issuecomment-242945011, or mute the thread https://github.com/notifications/unsubscribe-auth/AAB-4D8bpXpougkJc4mmAmc7_8EfWj53ks5qkL3qgaJpZM4Juy9Z .

idf commented 8 years ago

It really depends on the targeting audience of the this document. Unless it were for advanced readers, pred and other short forms would not benefit much.

jethrolarson commented 8 years ago

It's not for advanced people. It's for beginners

On Sat, Aug 27, 2016, 8:06 PM Daniel D. Zhang notifications@github.com wrote:

It really depends on the targeting audience of the this document. Unless it were for advanced readers, pred and other short forms would not benefit much.

— You are receiving this because you commented.

Reply to this email directly, view it on GitHub https://github.com/hemanth/functional-programming-jargon/issues/108#issuecomment-242953308, or mute the thread https://github.com/notifications/unsubscribe-auth/AAB-4Iez6qU7O1ENPjvS1jj9TDPByVgcks5qkPscgaJpZM4Juy9Z .