better documentation and positioning