nutshell example; small description; todo++;

Updated nutshell example to match the actual api, 
wrote a small description of what's happening in the library,
updated todo.