From 19a0a6984f515da7006a2a54a80c369cff83da33 Mon Sep 17 00:00:00 2001 From: Brad Dunn Date: Tue, 5 Jan 2021 08:43:22 -0500 Subject: [PATCH] Add note about externals and interface files --- pages/docs/manual/latest/external.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/pages/docs/manual/latest/external.mdx b/pages/docs/manual/latest/external.mdx index 11882d88b..474df2557 100644 --- a/pages/docs/manual/latest/external.mdx +++ b/pages/docs/manual/latest/external.mdx @@ -78,6 +78,8 @@ However, if you want to more rigidly bind to the JavaScript library you want, ke Additionally, no extra ReScript-specific runtime is better for output readability. +> **Note:** do also use `external`s and the `@bs.blabla` attributes in the interface files. Otherwise the inlining won't happen. + ## Design Decisions ReScript takes interoperating with existing code very seriously. Our type system has very strong guarantees. However, such strong feature also means that, without a great interop system, it'd be very hard to gradually convert a codebase over to ReScript. Fortunately, our interop are comprehensive and cooperate very well with most existing JavaScript code.