various updates and new documentation