Guess we should do some high level architecture overview there or some blog post explaining how swaps work.

That's the overhead of being non custodial and doing submarine atomic swaps. That being said, we are working on making those miner fees much cheaper ;)