Add description of UMD modules to Modules.md in addition to Writing Declaration Files.md

Author: Andy Hanson

pages/Modules.md

@@ -517,6 +517,31 @@ import x, {y} from "hot-new-module";
 x(y);
 ```
 
+### UMD modules
+
+Some libraries can be used either through imports or through globals.
+
+##### math-lib.d.ts
+
+```ts
+export const isPrime(x: number): boolean;'
+export as namespace mathLib;
+```
+
+The library can then be used as an import within modules:
+
+```ts
+import { isPrime } from "math-lib";
+isPrime(2);
+mathLib.isPrime(2); // ERROR: can't use the global definition from inside a module
+```
+
+It can also be used as a global variable, but only inside of a script:
+
+```ts
+mathLib.isPrime(2);
+```
+
 # Guidance for structuring modules
 
 ## Export as close to top-level as possible