update a bit on documentation, still a work in progress