properly document nullable params
fix crosslinks