some fixes found writing documentation