better and more complete docs