Proxy-WASM ABI Part 1.

[jplevyak]

For an explanation of how to fill out the fields, please see the relevant section
in PULL_REQUESTS.md

Description: Proxy-WASM ABI Part 1.
Risk Level: Low
Testing: N/A
Docs Changes:
Release Notes:
[Optional Fixes #Issue]
[Optional Deprecated:]

[repokitteh-read-only]

CC @envoyproxy/api-shepherds: Your approval is needed for changes made to api/.

🐱

Caused by: #9257 was opened by jplevyak.

see: more, trace.

[htuch]

Thanks for the split. I'd like to see if we can understand this with a context free Envoy developers hat on as a first step.

[jplevyak]

Added Doxygen comments. PTAL

[htuch]

Thanks for the Doxygen. A few followup questions.
/wait

[mattklein123]

Per my other comment, IMO we need a high level design doc to make sure we have a shared understanding. Thank you!

/wait

[jplevyak]

Where would be the best place for the design docs? envoy/api/wasm/v0/* or envoy/docs/root/wasm ?

[mattklein123]

Where would be the best place for the design docs? envoy/api/wasm/v0/* or envoy/docs/root/wasm ?

I commented elsewhere on where I would like to see the docs (I can't remember where, in one of these PRs). Please also check your email. In the short term I really want to see a 1-2 page overview which can be in the form of a gdoc, before we merge the final docs in.

[mattklein123]

Putting this into waiting until we finalize the overview doc that is floating around. That will help make reviews go much faster.

/wait

[mattklein123]

LGTM modulo file moves. Thank you!

/wait

[htuch]

LGTM (with the file move and addressing last nit thread).

[mattklein123]

LGTM, thanks @htuch @lizan @yskopets any further comments?

[htuch]

LGTM, needs format fix, thanks!

[mattklein123]

Thanks!