| # New C++ bindings headers | |
| The headers in this directory are meant to support the new C++ bindings | |
| (https://fxbug.dev/42138399). The headers would be exposed to users via the same include | |
| pattern as those from the high-level C++ bindings at //sdk/lib/fidl/cpp, | |
| i.e. `#include <lib/fidl/cpp/foobar.h>`. The intention is that as the unified | |
| C++ bindings becomes the prevalent C++ bindings API, we won't have to make | |
| another LSC to move the header locations. Therefore, a bit of extra attention is | |
| needed to ensure the headers and definitions in this library don't collide with | |
| those in //sdk/lib/fidl/cpp. | |
| Different from //sdk/lib/fidl/cpp, this library has an explicit "include" folder | |
| that hosts the headers. This is desirable because we avoid exposing the entire | |
| "//src" tree available for inclusion otherwise. Given enough time, we should | |
| migrate libraries in //sdk to use a dedicated "include" folder too. | |
| ## Design | |
| See [structure of new C++ FIDL bindings](docs/structure-of-unified-cpp-fidl-bindings.md). |