improve docs, exports debug boolean