fix documentation, add new sections