add index and some more docs