doc formatting
rewrote all the adapters