22 ms·
Yes that does seem to be the model in a lot of open source as documentation is normally rather lacking and is of the look hers how to add 2+2 than covering the
by mjwalshe 14y ago
Yes that does seem to be the model in a lot of open source as documentation is normally rather lacking and is of the look hers how to add 2+2 than covering the product in depth.
Ive been using mysql for 10+ years and the documentation on security still hurts my brain to look at - and AWS is even worse one of my developer colleges was unable to decipher how to log onto one of our aws systems even though he had the AWS login - the documentaion is confusing poorly written and in some key places just wrong!
- viraptor 14y agoI'm not sure why bad documentation seems to be the open-source domain. I'm equally surprised to find useful documentation in both open and closed software really. The main difference is that open-source docs are usually lacking in general, while closed-source docs are there in large quantities (if someone figured out auto-generation, there's hundreds of pages) but still don't tell you anything important. The only part that changes is that someone was forced by contract to produce something - but it doesn't need to be usable. I think these days I actually prefer to just look at the code to see what's going on rather than hope that on page 2xx I'll find something useful. Only the first source will never lie.