improve documentation, include todos
improve documentation, include todos

numenta/nupic.research,mrcslws/nupic.research,subutai/nupic.research,numenta/nupic.research,mrcslws/nupic.research,subutai/nupic.research