docs improvements
better linkouts for layout authors