search

tldr-pages / tldr-pages.github.io

🌐 The website for the tldr pages project
http://tldr.sh/
MIT License
76 stars 36 forks source link

Show official Python client #29

Closed pr0gramista closed 6 years ago

pr0gramista commented 6 years ago

No offense to lord63, but official Python client is just better and it is not listed on the site. I thought I needed to use tldr.py, which requires reading manual to use.

I have installed official one only because I googled it.

agnivade commented 6 years ago

The official client is listed here - https://github.com/tldr-pages/tldr#clients.

Probably you can add the official client instead of replacing the existing one. That way, we are consistent with the github page.

waldyrious commented 6 years ago

In @pr0gramista's defense, the website presents a single client for each platform/ecosystem, while the README has a more exhaustive list with multiple entries in several categories. This may give the impression that the entries on the website are hand-picked selections of the most appropriate clients for each platform, which is an understandable perception even if it's not really intentional (at least I'm not aware of there being such an intention, but I might be misremembering).

I do think that we need a better solution in the long term to list the clients consistently, but in this particular case, adding two entries for Python clients would break the apparent pattern on the website, and would still remain a long way from consistency with the README, so IMO it would result in an even worse status than what we currently have.

So my vote is to merge this PR as-is, while remaining open to a more adequate solution for the listing of clients (integrating the website, the readme and the the wiki).

agnivade commented 6 years ago

Done