Work around issue #36, improve Core API documentation