Reorganize docs for wiki links

Author: BarkingBad

docs/docs/usage/scaladoc/docComments.md renamed to docs/docs/usage/scaladoc/linkingDocumentation.md

@@ -1,5 +1,5 @@
 ---
-title: API Documentation
+title: Linking documentation
 ---
 
 # {{ page.title }}

docs/docs/usage/scaladoc/scaladocDocstrings.md

@@ -121,8 +121,9 @@ Scaladoc provides two syntax parsers: `markdown` (default) or `wikidoc`.
 
 #### Markdown
 
-Markdown uses commonmark flavour to parse docstring, however it can understand `wikidoc` links.
-For more info about wiki links look at this [chapter](#linking-to-api)
+Markdown uses commonmark flavour with extension of `wikidoc` links for referencing convenience.
+Recent commonmark flavour rules can be found [here](https://commonmark.org/)
+
 
 #### Wikidoc
 
@@ -142,6 +143,8 @@ __underline__
 [[https://external.link External Link]], e.g. [[https://scala-lang.org Scala Language Site]]
 ```
 
+For more info about wiki links look at this [chapter](#linking-to-api)
+
 Other formatting notes
 
 - Paragraphs are started with one (or more) blank lines. `*` in the margin for the comment is valid (and should be included) but the line should be blank otherwise.
@@ -179,10 +182,8 @@ More details on writing Scaladoc
 
 Further information on the formatting and style recommendations can be found in Scala-lang scaladoc style guide.
 
-
-
 ## Linking to API
 
 Scaladoc allows linking to API documentation with Wiki-style links. Linking to
 `scala.collection.immutable.List` is as simple as
-`[[scala.collection.immutable.List]]`. For more information on the exact syntax, see [doc comment documentation](./docComments.html#definition-links).
+`[[scala.collection.immutable.List]]`. For more information on the exact syntax, see [doc comment documentation](./linkingDocumentation.html#definition-links).