short docs / fixes