News for hackers. Stuff that matters.
Re:The Code Documentation Fallacy by j_baker on Thursday October 17, 2013 @02:18PM (#6567160)
You can change an API without removing functionality. Sometimes you want to add functionality. Or sometimes the context around the API changes. Like for example, a python API might not function the same in Python 2.5, Python 2.7, and Python 3.

All I know is, I help maintain a very large set of public APIs that my team is very resistant to changing, and yet somehow the docs are still out of date.

Re:The Code Documentation Fallacy by gobengo on Friday October 18, 2013 @05:19AM (#6570459)
Is that because you're not updating your docs?