Hey!
As you can see I did not use our Wiki (as we used to) because it doesn't support inline comments (which is pretty bad in my opinion). I would like to propose to keep all the designs along with our source code. This approach has been successfully used by the Kubernetes [1] folks (although they migrated designs into the new Community repository [2] recently). I think it might be a good idea to do something similar.
Feedback on both items is more than welcome.
Thanks,
Sebastian