updated documentation of learned things