update documentation, readme, tweak inlining