by theSage on 5/19/19, 7:27 AM with 72 comments
I'm looking for examples which fall along the lines of "fail to see the forest for the trees".
by neya on 5/19/19, 10:48 AM
The top pick goes to WooCommerce, although an open source E-commerce solution on top of Wordpress, it has some terrible decisions under the hood.
The top pick would go to mixing presentational logic with business logic. For example, to render a table, instead of exposing an array of objects to allow the developer to loop through it as he/she sees fit, WooCommerce will force you to use a PHP function that renders a table for you and there's actually no way to modify the presentation logic if you wanted to.
It's a really fundamental programming paradigm that even top open source companies fail to adhere to.
Again, I'm not saying this to attack them or the maintainers behind the code, just my opinion of why I think it's bad quality code while respecting the fact that developers still do take time and effort for us to enjoy something with freedom and zero cost.
by ben_bai on 5/19/19, 3:01 PM
http://cvsweb.openbsd.org/cgi-bin/cvsweb/~checkout~/src/usr....
https://github.com/coreutils/coreutils/blob/master/src/true....
by codr7 on 5/19/19, 10:39 AM
That being said, the worst I ever saw was the in-house business nonsense I was paid to deal with as a Java consultant. The worst code isn't open source from my experience, subjecting it to public scrutiny would mean suicide for the companies involved.
by jasode on 5/19/19, 1:33 PM
I was reminded of that short-sighted decision every time I ripped a bunch of CDs and saw how importing song titles was not automatic because a dozen different discs had the same hash ids which resulted in collisions[1]. It ended up creating needless friction for millions that depended on that discid.
What's sad is I'm not even sure if one can extract any useful "lessons learned" from it! The programmer that wrote it was not an amateur script kiddie; he had a computer science degree from Uni California. Apparently, he didn't realize he was writing a flawed hash algorithm as he wrote it.
One could say that hash algorithms should be "peer reviewed". Well, he got unsolicited peer review that pointed how his homegrown hashing computation was flawed but he ignored the suggestion to improve it.
[0] >Ti Kan wanted to use a hash. He could have chosen something like CRC32, which would have given him a 32 bit number, yielding 4 billion unique IDs. Instead he wrote his own hash. [...] Ti Kan was made aware (not by me) of this problem back in 1994, and given a script to convert this format into a CRC32-based format, but he rejected it because the deployed base was too big. At that point it was probably in the high dozens. -- excerpt from http://quimby.gnus.org/circus/notes/cddb.html
[1] https://forums.macrumors.com/attachments/multiple-matches-jp...
by AnaniasAnanas on 5/19/19, 10:51 AM
Tip: If you ever end up in a situation where you have to copy-paste code with minor changes then there is something that you are doing wrong. In this case using arrays and loops would be a much better solution.
by spion on 5/19/19, 12:26 PM
Or examples of projects that did things one way, but later refactored, and why they refactored.
by kissgyorgy on 5/19/19, 3:03 PM
by otras on 5/19/19, 3:06 PM
by Sir_Cmpwn on 5/19/19, 3:21 PM
https://github.com/vatt849/LibMinecraft/blob/master/LibMinec...
The whole library is a trip if you want to read a bunch of bad C#. Highlights:
- Generated documentation
- Giant switch/case instead of a more organized dispatch map
- Large swaths of commented code instead of using version control
- try...catch statements that just eat the errors
- Inconsistent code style
- This thing:
https://github.com/vatt849/LibMinecraft/blob/master/LibMinec...
I've written something similar from scratch since, which I'm still not entirely satisfied with, but is much better for reference:
https://github.com/ddevault/TrueCraft
The client-side networking code lives here:
https://github.com/ddevault/TrueCraft/blob/master/TrueCraft....
https://github.com/ddevault/TrueCraft/blob/master/TrueCraft....
https://github.com/ddevault/TrueCraft/tree/master/TrueCraft....
Notable improvements:
- Handwritten docs only where necessary
- Uses a stream implementation for decoding this particular wire format
- Has a different and better abstraction for reading packets out
Still has bad error handling though.
by slezyr on 5/19/19, 11:43 AM
https://github.com/angelXwind/OpenSyobonAction/blob/master/m...
by jstarfish on 5/19/19, 6:51 PM
https://github.com/TheVamp/Terraria-Source-Code
It is another example of how even inelegant code full of hardcoded values can be successful.
by twhitmore on 5/19/19, 12:05 PM
Having said that:
1) iText PDF library used to have some fairly poor & duplicated code. Column layout was a highlight. Also strange ideas overemphasizing subclasses, eg. for paragraph styles. (Correct approach: use values rather than types.)
2) Tomcat webserver back around 2007 used to have some amazing 'clustering' code to deploy your webapp across multiple servers. But it lacked proper knowledge & hence control of what it was doing. IIRC there was no clear master, and a server couldn't tell what had been started on it versus what had been replicated since a peer was seen to be running it. Effect: replication would be additive only, contexts would just replicate everywhere uncontrolled, and there was no good way to stop/ undeploy an app across the cluster.
by ddebernardy on 5/19/19, 12:42 PM
by type0 on 5/19/19, 3:31 PM
by blattimwind on 5/19/19, 1:16 PM
OpenSSL is still an excellent example for very messy code where even maintainers / frequent contributors regularly get lost. Also a good example for designing many bad APIs and poor docs. libsodium is a good counterexample, although the internal structuring of the code base is a bit atypical, it is logical and consistent. (It does have some API idiosyncrasies which cater specifically to dynamic bindings, like providing a constant always as a #define/macro but also as an exported function; and it has a bit of an issue where you have both legacy APIs and newer APIs, but the docs are pretty clear on which is which).
BorgBackup is an example of how you don't want to mix C and Python code, and also contains various bits that only 1-2 people on the planet really bothered to understand, besides demonstrating other issues of organically grown code bases.
by bradknowles on 5/19/19, 5:00 PM
You have to turn that equation around. Even if all you know right now is the negative thing you don’t want, you have to figure out how to reframe that into the positive thing you do want. On,y then can you make positive progress towards that thing you want — and by the way, you will naturally avoid the things you don’t want by focusing on the things you do want.
Sure, examples of bad stuff can be instructive, but only so far as it helps you further clarify the good stuff you’re actually trying to achieve.
by superpermutat0r on 5/19/19, 2:54 PM
by arthev on 5/19/19, 1:37 PM
by pjc50 on 5/19/19, 1:24 PM
I think I'm going to need an example to understand this?
Having said that, one of the most informative programming books I've ever read was C Traps And Pitfalls. Flags common easily-made errors and explains them, which in turn fixes misconceptions about the language. I feel most languages could do with one.
by ksaj on 5/19/19, 5:25 PM
by RickJWagner on 5/19/19, 1:34 PM
All of us are stronger than any one of us. Long live Open Source!
by craftoman on 5/20/19, 4:50 AM
by frostburg on 5/19/19, 3:22 PM
by sam_lowry_ on 5/19/19, 12:28 PM
by peterwwillis on 5/19/19, 3:22 PM
by jxub on 5/20/19, 11:33 AM
by yamann on 5/19/19, 10:49 AM