doc update: little intro with some useful links