global position additions to docs