Documentation on how/why this works

There's nothing in the readme that explains how this works, a link or documentation on that would go a long way for understanding. for instance, pure compute may have good 1:1 but how about HTTP calls.

Start with the repository README and identify the existing explanation of how jsii works. Document or link to an explanation that addresses the issue's examples, including pure computation and HTTP calls, so readers can understand the relevant behavior and know how those cases differ.

Written by the indexing model from the issue text.