Support @copydoc or enhance @inheritdoc

[samchon]

I want some features to be added.

@copydoc

Copy definition from another one.

If I need to define same content on another object, then it's very annoying. Look at the below codes, then you may understand how I am suffering from duplicated definitions

• ParallelSystemArray
  • ParallelServerArray
  • ParallelClientArray
  • ParallelServerClientArray
• ParallelSystemArrayMediator
  • ParallelServerArrayMediator
  • ParallelClientArrayMediator
  • ParallelServerClientArrayMediator

@inheritdoc

The @inheritdoc feature in TypeDoc copies definition from its parent class. However, it's standalone. It doesn't allow using the @inheritdoc as subsidiary one.

Overriding a method means some logics are changed and some explanation is required. I want to combine @inheritdoc with customized comments explaining what is changed.

/**
 * This is the parent class.
 * 
 * Blah blah blah...
 */
class ParentClass
{
    /**
     * Do something.
     */
    public domSomething(): void
    {
    }
}

/**
 * This is a child class derived from the {@link ParentClass}
 *
 * #### [Inherited] {@link ParentClass}
 * @copy8doc ParentClass
 */
class ChildClass
{
    /**
      * On top of its parent, {@link ChildClass.doSomething} do something more.
      * 
      * @inheritdoc
      */
    public doSomething(): void
    {
    }
}

[Gerrit0]

TypedDoc's @inheritDoc supports copying documentation from another arbitrary documented symbol as of 0.23.

I'm really wary to add additional copying methods which won't be recognized by VSCode, and will result in worse docs for people using the language service to read documentation (the majority of declaration file use, in my experience)

I'm open to doing something like this if enough people want it, but a proposal like it needs to describe how it will play with comment tags, where it's permitted, when it is resolved, etc... I don't want to add a feature that few people know exists, and fewer how to use properly, like several existing features...