README updates and client factoring