Make sure TypeAliases get proper docstrings and linked aliases

Author: felixmulder

doc-tool/resources/_layouts/api-page.html

@@ -22,6 +22,7 @@
         <span id="entity-name">
             {{ entity.name }}
         </span>
+        {% if entity.typeParams.size > 0 %}
         <span id="entity-type-params">
             <span class="no-left">[</span>
             {% for param in entity.typeParams %}
@@ -35,6 +36,7 @@
             {% endfor %}
             <span class="no-left">]</span>
         </span>
+        {% endif %}
         {% if entity.superTypes.size > 0 %}
         <div id="super-types">
             {% for super in entity.superTypes %}

doc-tool/src/dotty/tools/dottydoc/core/DocstringPhase.scala

@@ -63,4 +63,8 @@ class DocstringPhase extends DocMiniPhase with CommentParser with CommentCleaner
   override def transformVal(implicit ctx: Context) = { case ent: ValImpl =>
     ent.copy(comment = parsedComment(ent))
   }
+
+  override def transformTypeAlias(implicit ctx: Context) = { case ent: TypeAliasImpl =>
+    ent.copy(comment = parsedComment(ent))
+  }
 }

doc-tool/src/dotty/tools/dottydoc/core/TypeLinkingPhases.scala

@@ -26,6 +26,14 @@ class LinkReturnTypes extends DocMiniPhase with TypeLinker {
     val returnValue = linkReference(vl, vl.returnValue, ctx.docbase.packages)
     vl.copy(returnValue = returnValue)
   }
+
+  override def transformTypeAlias(implicit ctx: Context) = { case ta: TypeAliasImpl =>
+    ta.alias.map { alias =>
+      val linkedAlias = linkReference(ta, alias, ctx.docbase.packages)
+      ta.copy(alias = Some(linkedAlias))
+    }
+    .getOrElse(ta)
+  }
 }
 
 class LinkParamListTypes extends DocMiniPhase with TypeLinker {