[OT] of [OT] I am a developer and I hate documentation

ketmar via Digitalmars-d digitalmars-d at puremagic.com
Thu Aug 18 09:56:32 PDT 2016


On Thursday, 18 August 2016 at 16:17:15 UTC, H. S. Teoh wrote:
> if the stub reads:
>
> 	/**
> 	 * THE PROGRAMMER WAS TOO LAZY TO FILL THIS IN
> 	 * Params:
> 	 *	x = THE PROGRAMMER WAS TOO LAZY TO FILL THIS IN
> 	 *	y = THE PROGRAMMER WAS TOO LAZY TO FILL THIS IN
> 	 * Returns: THE PROGRAMMER WAS TOO LAZY TO FILL THIS IN
> 	 */
> 	int myFunc(int x, int y) { ... }
>
> :-P
i assure you that programmers will still be too lazy to fill the 
docs. but they *will* spend alot of time rebuilding (or 
hex-editing if there is no source) their IDE to replace the 
message.


More information about the Digitalmars-d mailing list