overall documentation improvements