From 8f7afd22e50b1718e062c54701e258e5ca2ad715 Mon Sep 17 00:00:00 2001
From: Mike Gerwitz <mike.gerwitz@rtspecialty.com>
Date: Wed, 23 Oct 2019 10:39:04 -0400
Subject: [PATCH] doc/hacking.texi (TypeScript Migration): .d.ts reference

The original suggestion for interfaces (see diff) is much more
confusing.  We've found .d.ts files to work well for incremental migration.
---
 doc/hacking.texi | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/doc/hacking.texi b/doc/hacking.texi
index b445e10..f848bb6 100644
--- a/doc/hacking.texi
+++ b/doc/hacking.texi
@@ -341,14 +341,17 @@ If this is a concern,
     in conjunction with ease.js'
     @url{https://www.gnu.org/software/easejs/manual/easejs.html#Type-Checks-and-Polymorphism,@samp{Class.isA}}.
 
-Interfaces do not exist at runtime in TypeScript,
-  but they do in easejs.
-Consequently,
-  you can continue to export an ease.js interface while also exporting
-    a TypeScript interface.
+Often times you will need to reference a class or interface as a
+  dependency before it has been migrated away from ease.js.
 To do this,
-  continue to export using @samp{module.exports} rather than
-    TypeScript's @samp{export =}.
+  create a corresponding @code{.d.ts} file in the same directory
+    as the dependency.
+For example,
+  if a class @code{Foo} is contained in @file{Foo.js},
+    create a sibling @file{Foo.d.ts} file.
+For more information,
+  see @url{https://www.typescriptlang.org/docs/handbook/declaration-files/introduction.html,Declaration Files}
+  in the TypeScript handbook.
 
 ease.js implements stackable Scala-like traits.
 Traits are @emph{not} provided by TypeScript.