Improve docs: why do we ignore almost all the FP jargon in this project

[sobolevn]

• Describe our decision
• Add a link to: https://github.com/jmesyou/functional-programming-jargon.py
• Improve https://github.com/jmesyou/functional-programming-jargon.py with returns links and examples

[thepabloaguilar]

Can FP users understand what is "a thing" without jargon? Can they correlate "a thing" to a jargon?
If the answers to these questions are "yes" I think we can "ignore" the FP jargon to be more inclusive with people that do not understand it!

On the other hand, we have to get these people familiar with FP jargon to understand what they are using.

[thepabloaguilar]

What's the final decision here? Will we get out of FP jargons?

[sobolevn]

Yes, we don't use it. (As a matter of fact).

The history behind this is really interesting. The first name of this project was dry-monads: https://github.com/dry-python/returns/tree/0.1.0

But, then I got a lot of uneducated feedback. It was hard to manage. So, instead we went to make this concept hidden.
And it worked!

Basically, we came up with our own terms that do mean the similar things. And we should stick to them.

[thepabloaguilar]

So, the first item was completed I guess.

• Describe our decision

Answer:

then I got a lot of uneducated feedback. It was hard to manage. So, instead we went to make this concept hidden.
And it worked!
Basically, we came up with our own terms that do mean the similar things. And we should stick to them.

---

Where we have to add the link? On the first page?

• Add a link to: https://github.com/jmesyou/functional-programming-jargon.py

What exactly we have to improve?

• Improve https://github.com/jmesyou/functional-programming-jargon.py with returns links and examples

[sobolevn]

What exactly we have to improve?

There are a lot of concepts that are poorly illustrated in the original article: https://github.com/jmesyou/functional-programming-jargon.py

I guess we can improve almost every point in there 🙂

[thepabloaguilar]

What about we bring this article to a repository inside dry-python, creating a new one or forking??
functional-programming-jargon.py seems like just a copy-paste "parsing" the code from JS to Python without worried about if it's the correct way to explain using Python!

[thepabloaguilar]

If we create a repository inside dry-python it's easier to update it, you've opened a PR there 23 days ago and so far you haven't got any response!

[sobolevn]

Great idea!

[sobolevn]

New repo: https://github.com/dry-python/functional-jargon-python

[thepabloaguilar]

How do you want to do this??
Maybe copy-paste the structure from https://github.com/jmesyou/functional-programming-jargon.py without the content of each topic and we can progressively be adding the content by ourselves?

[sobolevn]

Sounds like a plan 👍