title: Are full absolute paths in links inside markdown files of GitHub repositories inevitable if we want to publish the package to npm?
body: <p>Assume that we have the GitHub repository with below 2 Markdown files:</p>
  <ul>
  <li>README.md</li>
  <li>Documentation/SampleDocumentationPage.md</li>
  </ul>
  <p>From the <strong>README.md</strong> we can refer to <strong>SampleDocumentationPage</strong> by relative path or shortened absolute path:</p>
  <pre><code>See [sample documentation page](Documentation/SampleDocumentationPage.md)
  </code></pre>
  <p>If we publish the package to NPM, the <strong>README.md</strong> will displaying on package's main page which has below URL.</p>
  <pre><code>https://www.npmjs.com/package/$SCOPE_NAME$/$PACKAGE_ID$
  </code></pre>
  <p>Will link to <strong>SampleDocumentationPage.md</strong> in <strong>README.md</strong> work?
  I suppose no, because correct absolute path of <strong>SampleDocumentationPage.md</strong> is</p>
  <pre><code>https://github.com/$USER_NAME$/$REPOSITORY_NAME$/blob/master/Documentation/SampleDocumentationPage.md
  </code></pre>
  <p>while in relation to <strong>npm</strong> the computed URL of <strong>SampleDocumentationPage.md</strong> is</p>
  <pre><code>https://www.npmjs.com/package/$SCOPE_NAME$/$PACKAGE_ID$/Documentation/SampleDocumentationPage.md
  </code></pre>
  <p>Something possible to do with it except the usage of absolute paths only?
  The absolute paths in Markdown could be very long like:</p>
  <pre><code>&lt;dl&gt;
  
    &lt;dt&gt;&lt;a href=&quot;https://github.com/TokugawaTakeshi/Yamato-Daiwa-ES-Extensions/blob/master/CoreLibrary/Package/Documentation/Arrays/getArrayElementSatisfiesThePredicateIfSuchElementIsExactlyOne/getArrayElementSatisfiesThePredicateIfSuchElementIsExactlyOne.md&quot;&gt;getArrayElementSatisfiesThePredicateIfSuchElementIsExactlyOne&lt;/a&gt;&lt;/dt&gt;
    &lt;dd&gt;Returns the element of specified array matching with the predicate if such element is exactly one, otherwise error will be thrown or null will be returned (depending on dedicated option's value).&lt;/dd&gt;
  
    &lt;dt&gt;&lt;a href=&quot;https://github.com/TokugawaTakeshi/Yamato-Daiwa-ES-Extensions/blob/master/CoreLibrary/Package/Documentation/Arrays/getLastElementOfNonEmptyArray/getLastElementOfNonEmptyArray.md&quot;&gt;getLastElementOfNonEmptyArray&lt;/a&gt;&lt;/dt&gt;
    &lt;dd&gt;Returns the last element of array, herewith &lt;b&gt;UnexpectedEventError&lt;/b&gt; will be thrown if target array is empty.&lt;/dd&gt;
  
  &lt;/dl&gt;
  </code></pre>