add some extra documentation