reame tweaks
document helper fns