Source generator design document 🚧

[atifaziz]

This PR adds a design document for the source generator design. It is the basis for the final and desired implementation, which may happen over several iterations/versions as long as any one version does not deviate far.

It is in draft and therefore work in progress, but please feel free to comment on sections that already have content.