software development
This classic Eric Lippert post
[http://blogs.msdn.com/ericlippert/archive/2003/10/28/53298.aspx] describes, in
excruciating, painful detail, exactly how much work it takes to add a single
ChangeLightBulbWindowHandleEx function to a codebase at Microsoft:
> One dev to spend five minutes implementing ChangeLightBulbWindowHandleEx.One
program manager
documentation
Nicholas Zakas enumerates the number one reason why good JavaScript libraries
fail
[http://www.amazon.com/gp/plog/post.html/ref=cm_blog_pl/104-9847257-2963905?ie=UTF8&pt=personalBlog&aid=PlogMyCustomersAgent&ot=customer&pd=1164175937.423&pid=PMCA1J3TWE84RTHQXat1164175038&iid=A1J3TWE84RTHQX]
:
> Lack of documentation.
software development concepts
I was browsing around the CouchDb
[http://www.couchdb.com/CouchDB/CouchDBWeb.nsf/direct/Introduction] wiki
[http://couchdb.infogami.com/] yesterday when I saw Damien Katz' hilarious
description [http://couchdb.infogami.com/alpha1] of how technical documentation
really gets written. You know, in the real world:
> Welcome to
documentation
Have you ever noticed that much of the online MSDN .NET framework help is.. not
helpful? Take the the MSDN help for the IBindingList.AddIndex method
[http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfSystemComponentModelIBindingListClassAddIndexTopic.asp]
, for example:
Scott Swigart calls this undocumentation, and elaborates further
arcade gaming
After two weeks of non-stop tweaking, I think my MAME Cocktail arcade is finally complete. I created a MAME cocktail project page documenting everything I’ve done so far with lots of pictures and links to the products I used, and the rationales behind the choices I made.
Most of
software development
Evidently, Jerry Dennany is a member of the build machine cult:
One of the golden rules of modern software development is that one should build all software on a dedicated build machine.
A build machine should:
1. Be well documented. This includes Version of the Operating System, Service Pack level,