included doc for core functionality