docs improvements

layout opts autogen’d so no sync/forget to update issues; reorganise &
prepare for layout demos