more fixes to apidocs and added better hint docs