Merge pull request #2 from Gerrit0/patch-1

Update inheritdoc.md

pages/spec/tag_kinds.md

@@ -78,13 +78,19 @@ by `{` and `}` characters.  The `@link` and `@inheritDoc` tags are examples of i
 ```ts
 class Book {
   /**
-   * Saves the book to the database.
+   * Writes the book information into a JSON file.
    *
    * @remarks
-   * {@inheritDoc example-library#Serializer.writeFile}
-   *
-   * @deprecated
-   * Use {@link example-library#Serializer.writeFile} instead of this method.
+   * This method saves the book information to a JSON file conforming to the standardized
+   * {@link http://example.com/ | Example Book Interchange Format}.
+   */
+  public writeFile(options?: IWriteFileOptions): void {
+    . . .
+  }
+
+  /**
+   * {@inheritDoc Book.writeFile}
+   * @deprecated Use {@link Book.writeFile} instead.
    */
   public save(): void {
     . . .

pages/tags/inheritdoc.md

@@ -29,7 +29,8 @@ The `@inheritDoc` tag does not copy the entire comment body. Only the following
 - `@returns` block
 
 Other tags such as `@defaultValue` or `@example` are not copied, and need to be explicitly included after
-the `@inheritDoc` tag.
+the `@inheritDoc` tag. When the `@inheritDoc` tag is specified, neither the summary section nor the `@remarks`
+section may be specified in the comment.
 
 
 ## Example