improve docs, fix indexes and node retriever along the way
add a generic retriever
Merge branch 'basic/docs/for/all'