core.py docs updated