document "chi" in the core
