doc updates. core fixes.