Re:Reasons to avoid code comments
by seanmcdirmid on Saturday July 13, 2013 @08:30AM
(#6037397)
Good god, you've brought back nightmares about WPF documentation now. Want to know what XXX property means in WPF? Well, the documentation will helpfully tell you that "gets or sets the XXX property of the FULLNAMESPACE class."
I've learned that sometimes BIGCORP makes developers document something when they have nothing interesting to say.
Someone should design a programming language without commenting capabilities and figure out a new/different/better way to deal with library API documentation problems as well as implementation documentation.
I've learned that sometimes BIGCORP makes developers document something when they have nothing interesting to say.
Someone should design a programming language without commenting capabilities and figure out a new/different/better way to deal with library API documentation problems as well as implementation documentation.