explain another purpose for the license tag (#109)

Author: hegemonic

content/en/tags-license.md

@@ -16,6 +16,11 @@ You can use any text to identify the license you are using. If your code uses a
 license, consider using the appropriate identifier from the [Software Package Data Exchange (SPDX)
 License List][spdx].
 
+Some JavaScript processing tools, such as Google's Closure Compiler, will automatically preserve
+any JSDoc comment that includes a `@license` tag. If you are using one of these tools, you may wish
+to add a standalone JSDoc comment that includes the `@license` tag, along with the entire text of
+the license, so that the license text will be included in generated JavaScript files.
+
 [spdx]: https://spdx.org/licenses/
 
 
@@ -31,3 +36,32 @@ License List][spdx].
  */
 ```
 {% endexample %}
+
+{% example "A standalone JSDoc comment with the complete MIT license" %}
+
+```js
+/**
+ * @license
+ * Copyright (c) 2015 Example Corporation Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+```
+
+{% endexample %}

tags-license.html

@@ -42,13 +42,40 @@ <h2 id="overview">Overview</h2>
     <p>You can use any text to identify the license you are using. If your code uses a standard open-source license, consider using the appropriate identifier from
       the <a href="https://spdx.org/licenses/">Software Package Data Exchange (SPDX)
 License List</a>.</p>
+    <p>Some JavaScript processing tools, such as Google&#39;s Closure Compiler, will automatically preserve any JSDoc comment that includes a <code>@license</code>      tag. If you are using one of these tools, you may wish to add a standalone JSDoc comment that includes the <code>@license</code> tag, along with the entire
+      text of the license, so that the license text will be included in generated JavaScript files.</p>
     <h2 id="examples">Examples</h2>
     <figure>
       <figcaption>A module that is distributed under the Apache License 2.0</figcaption><pre class="prettyprint lang-js"><code>/**
  * Utility functions for the foo package.
  * @module foo/util
  * @license Apache-2.0
  */
+</code></pre>
+    </figure>
+    <figure>
+      <figcaption>A standalone JSDoc comment with the complete MIT license</figcaption><pre class="prettyprint lang-js"><code>/**
+ * @license
+ * Copyright (c) 2015 Example Corporation Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
 </code></pre>
     </figure>
   </article>