a proposal for bar orient configuration
some tidy up and docs regen