updated docs in core.py