Why do some opensouce libraries lack comments?

Posted by entropy on Programmers See other posts from Programmers or by entropy
Published on 2013-07-01T05:00:58Z Indexed on 2013/07/01 10:28 UTC
Read the original article Hit count: 306

Filed under:

open-source

|

libraries

|

comments

|

document

I don't know if this happens to most Opensource libraries, but many of I know and use (for example OpenSSL, Webkit, ...) they all lack comments, or contain very few comments.

Not to mention their very few documents, it is hard to read their source code. We can hardly understand what a member variable means, or what this function does. This seems to be against coding standard practice

Why is that? How can people collaborate to these opensource with very few comments?

© Programmers or respective owner

Related posts about open-source

Introducing Java/Open Source Daily, All the Java/Open Source Information You Need in One Newsletter

as seen on Internet.com - Search for 'Internet.com'
Internet.com launches a new daily newsletter to provide one-stop coverage of all the Java and Open Source information that matters to you. >>> More
Introducing Java/Open Source Daily, All the Java/Open Source Information You Need in One Newsletter

as seen on Internet.com - Search for 'Internet.com'
Internet.com launches a new daily newsletter to provide one-stop coverage of all the Java and Open Source information that matters to you. >>> More
The Open Source Open Source Conference

as seen on Internet.com - Search for 'Internet.com'
Portland, OR open source advocates took the loss of OSCON in stride: They launched their own open source conference. How did it stack up against the heavyweight, top-down competition? >>> More
Open Source: Open Source Contributions

as seen on Oracle Technology Network - Search for 'Oracle Technology Network'
Oracle investments in Linux yield substantial returns. >>> More
What are the strategies to become a good open source developer?

as seen on Programmers - Search for 'Programmers'
I always hear that involving with open source projects is good for career and the more (good) open source you release, the closer you will be to getting your dream job before you've even had an interview.I am expert in Java and I am trying to become fluent in Scala. I always think about getting involved… >>> More

Related posts about libraries

why do game engines prefer static libraries over dynamic link libraries

as seen on Stack Overflow - Search for 'Stack Overflow'
I've been reading a few gaming books. And they always prefer to create the engine as a static library over dynamic link. I am new to c++ so I am not highly knowledge when it comes to static libraries and dynamic link libraries. All I know is static libraries increase the size of your program, where… >>> More
which open source license to use for libraries depending on other libraries

as seen on Stack Overflow - Search for 'Stack Overflow'
I develop a couple of open source projects licensed under MPL1.1. All projects depend on a lot of other open source tools. I avoid any GPL licensed libraries for the viral nature of GPL. The licenses of the libraries my tools depend on are Apache2, LGPL2, LGPL3, CPL, BSD, JSON, MIT and some personal… >>> More
gcc linking shared libraries with dependent libraries

as seen on Stack Overflow - Search for 'Stack Overflow'
I have a complicated project with multiple executable targets and multiple shared libraries. The shared libraries currently don't have their dependent shared libraries linked in, and the result is that linker arguments to build the executables are hideously long and hard to maintain. I'd like to… >>> More
wxWidgets in Code::Blocks

as seen on Stack Overflow - Search for 'Stack Overflow'
Hello all, I'm trying to compile the minimal sample from the "Cross-Platform GUI Programming with wxWidgets" book but the following compile errors: ||=== minimal, Debug ===| C:\SourceCode\Libraries\wxWidgets2.8\lib\gcc_lib\libwxmsw28u_core.a(corelib_frame.o):frame.cpp:(.text+0x918)||undefined reference… >>> More
Differences Between NHibernate and Entity Framework

as seen on ASP.net Weblogs - Search for 'ASP.net Weblogs'
Introduction NHibernate and Entity Framework are two of the most popular O/RM frameworks on the .NET world. Although they share some functionality, there are some aspects on which they are quite different. This post will describe this differences and will hopefully help you get started with the one… >>> More