Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Don't (prominently) link to tldp.org for bash advice #171

Closed
rpdelaney opened this issue Jun 29, 2018 · 3 comments
Closed

Don't (prominently) link to tldp.org for bash advice #171

rpdelaney opened this issue Jun 29, 2018 · 3 comments

Comments

@rpdelaney
Copy link
Contributor

rpdelaney commented Jun 29, 2018

tldp.org's shell scripting pages have very high Google page rank. They're detailed, extensive, and easy to read, and much of the information in there is useful. But the examples they use are very often riddled with code that runs between smelly and bug-prone to outright dead wrong and dangerous. An advanced bash scripter could maybe read through tldp and filter out the bad stuff, but pointing newbies there is a bad thing indeed because they will learn lots of bash anti-patterns.

The tldp bash pages are too expansive to make a detailed review of everything that's wrong with them, and I'm not the most qualified person in the world to do so anyway. But this reddit post by @geirha is as good a spot as any to start getting an idea of what I'm talking about.

Instead, consider:

  • Greg's wiki: Bash Guide and Bash FAQ would be the starting point, and imho it wouldn't be bad to throw in an explicit link to Bash pitfalls too.
  • GNU Bash manual many GNU manuals are hidden treasures and in the case of bash, their manual is vastly more accurate than the sites with pagerank (like tldp.org).
  • Bash-hackers wiki This is prominently linked in the topic of the #bash IRC channel on freenode. Personally I don't think it's as useful overall as the links above, but it's still way better than tldp.
@budmc29
Copy link
Member

budmc29 commented Jun 29, 2018

Sounds good to me, and feel free to open a PR.
What do you think?
@kotp, @sjwarner-bp, @exercism/bash

@rpdelaney
Copy link
Contributor Author

PR submitted in #172 . Thanks!

budmc29 added a commit that referenced this issue Jul 2, 2018
Replace tldp.org with other resources per #171
@budmc29
Copy link
Member

budmc29 commented Jul 2, 2018

Fixed by #172

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants