Writerside markdown migration (#4457)

* Update compatibility-guide-17.md

* Update compatibility-guide-18.md

* Update compatibility-guide-19.md

* Update generics.md

* Update generics.md

* Update generics.md

* Update gradle-compiler-options.md

* Update k2-compiler-migration-guide.md

* Update multiplatform-compatibility-guide.md

* Update whatsnew17.md

* Update compiler-reference.md

* Update js-to-kotlin-interop.md

* Update generics.md

Author: zoobestik

docs/topics/compatibility-guides/compatibility-guide-17.md

@@ -421,7 +421,7 @@ perspective
 > **Deprecation cycle:**
 >
 > - 1.7.0: raise the deprecation level to a warning
-> - \> 1.7.0: remove the property
+> - > 1.7.0: remove the property
 
 ### Remove kotlinOptions.jdkHome compiler option
 
@@ -437,7 +437,7 @@ perspective
 > **Deprecation cycle:**
 >
 > - 1.5.30: raise the deprecation level to a warning
-> - \> 1.7.0: remove the option
+> - > 1.7.0: remove the option
 
 ### Remove noStdlib compiler option
 
@@ -487,4 +487,4 @@ perspective
 >
 > **Deprecation cycle:**
 >
-> - 1.7.0: inputs are not available, the output is replaced, the `classpath` property is deprecated
+> - 1.7.0: inputs are not available, the output is replaced, the `classpath` property is deprecated

docs/topics/compatibility-guides/compatibility-guide-18.md

@@ -638,4 +638,4 @@ perspective
 > **Deprecation cycle:**
 >
 > - 1.8.0: raise the deprecation level to a warning
-> \>= 1.9: delete the property
+> >= 1.9: delete the property

docs/topics/compatibility-guides/compatibility-guide-19.md

@@ -551,4 +551,4 @@ perspective
 > **Deprecation cycle:**
 >
 > * 1.8.0: raise the deprecation level to a warning
-> * \>= 1.9: delete the property
+> * >= 1.9: delete the property

docs/topics/compiler-reference.md

@@ -77,7 +77,7 @@ their names and behavior may be changed without notice.
 
 Specify a custom path to the Kotlin compiler used for the discovery of runtime libraries.
   
-### -P plugin:_pluginId_:_optionName_=_value_
+### -P plugin:pluginId:optionName=value
 
 Pass an option to a Kotlin compiler plugin.
 Available plugins and their options are listed in the **Tools > Compiler plugins** section of the documentation.

docs/topics/generics.md

@@ -86,7 +86,7 @@ _or a subtype of_ `E`, not just `E` itself. This means that you can safely _read
 (elements of this collection are instances of a subclass of E), but _cannot write_ to
 it as you don't know what objects comply with that unknown subtype of `E`.
 In return for this limitation, you get the desired behavior: `Collection<String>` _is_ a subtype of `Collection<? extends Object>`.
-In other words, the wildcard with an _extends_\-bound (_upper_ bound) makes the type _covariant_.
+In other words, the wildcard with an _extends_-bound (_upper_ bound) makes the type _covariant_.
 
 The key to understanding why this works is rather simple: if you can only _take_ items from a collection,
 then using a collection of `String`s and reading `Object`s from it is fine. Conversely, if you can only _put_ items
@@ -183,7 +183,7 @@ fun demo(x: Comparable<Number>) {
 The words _in_ and _out_ seem to be self-explanatory (as they've already been used successfully in C# for quite some time),
 and so the mnemonic mentioned above is not really needed.  It can in fact be rephrased at a higher level of abstraction:
 
-**[The Existential](https://en.wikipedia.org/wiki/Existentialism) Transformation: Consumer in, Producer out\!** :-)
+**[The Existential](https://en.wikipedia.org/wiki/Existentialism) Transformation: Consumer in, Producer out!** :-)
 
 ## Type projections
 
@@ -314,7 +314,7 @@ sort(listOf(HashMap<Int, String>())) // Error: HashMap<Int, String> is not a sub
 ```
 
 The default upper bound (if there was none specified) is `Any?`. Only one upper bound can be specified inside the angle brackets.
-If the same type parameter needs more than one upper bound, you need a separate _where_\-clause:
+If the same type parameter needs more than one upper bound, you need a separate _where_-clause:
 
 ```kotlin
 fun <T> copyWhenGreater(list: List<T>, threshold: T): List<String>

docs/topics/gradle/gradle-compiler-options.md

@@ -280,7 +280,7 @@ Also, see [Types for compiler options](#types-for-compiler-options).
 | `main` | Define whether the `main` function should be called upon execution | "call", "noCall". Also, see [Types for compiler options](#types-for-compiler-options) | "call" |
 | `metaInfo` | Generate .meta.js and .kjsm files with metadata. Use to create a library | | true |
 | `moduleKind` | The kind of JS module generated by the compiler | "umd", "commonjs", "amd", "plain", "es". Also, see [Types for compiler options](#types-for-compiler-options) | "umd" |
-| `outputFile` | Destination *.js file for the compilation result | | "\<buildDir>/js/packages/\<project.name>/kotlin/\<project.name>.js" |
+| `outputFile` | Destination *.js file for the compilation result | | "<buildDir>/js/packages/<project.name>/kotlin/<project.name>.js" |
 | `sourceMap` | Generate source map | | true |
 | `sourceMapEmbedSources` | Embed source files into the source map | "never", "always", "inlining". Also, see [Types for compiler options](#types-for-compiler-options) |  |
 | `sourceMapNamesPolicy` | Add variable and function names that you declared in Kotlin code into the source map. For more information on the behavior, see our [compiler reference](compiler-reference.md#source-map-names-policy-simple-names-fully-qualified-names-no). | "simple-names", "fully-qualified-names", "no". Also, see [Types for compiler options](#types-for-compiler-options)                                                              | "simple-names" |

docs/topics/js/js-to-kotlin-interop.md

@@ -182,7 +182,7 @@ See how Kotlin types are mapped to JavaScript ones:
 | `Unit`                                                                      | Undefined                  | Exportable when used as return type, but not when used as parameter type.                 |
 | `Any`                                                                       | `Object`                   |                                                                                           |
 | `Throwable`                                                                 | `Error`                    |                                                                                           |
-| Nullable `Type?`                                                            | `Type | null | undefined` |                                                                                            |
+| Nullable `Type?`                                                            | `Type | null | undefined`  |                                                                                            |
 | All other Kotlin types (except for those marked with `JsExport` annotation) | Not supported              | Includes Kotlin's [unsigned integer types](unsigned-integer-types.md).                    |
 
 Additionally, it is important to know that:

docs/topics/k2-compiler-migration-guide.md

@@ -1274,7 +1274,7 @@ for further reading. Changes listed with an asterisk (*) next to the Issue ID ar
 | [KT-55111](https://youtrack.jetbrains.com/issue/KT-55111)  | OptIn: forbid constructor calls with default arguments under marker                                                                        |
 | [KT-61182](https://youtrack.jetbrains.com/issue/KT-61182)  | Unit conversion is accidentally allowed to be used for expressions on variables + invoke resolution                                        |
 | [KT-55199](https://youtrack.jetbrains.com/issue/KT-55199)  | Forbid promoting callable references with adaptations to KFunction                                                                         |
-| [KT-65776](https://youtrack.jetbrains.com/issue/KT-65776)  | [LC] K2 breaks \`false && ...\` and \`false \|\| ...\`                                                                                     |
+| [KT-65776](https://youtrack.jetbrains.com/issue/KT-65776)  | [LC] K2 breaks \`false && ...\` and \`false || ...\`                                                                                     |
 | [KT-65682](https://youtrack.jetbrains.com/issue/KT-65682)  | [LC] Deprecate \`header\`/\`impl\` keywords                                                                                                |
 | [KT-45375](https://youtrack.jetbrains.com/issue/KT-45375)  | Generate all Kotlin lambdas via invokedynamic + LambdaMetafactory by default                                                               |
 
@@ -1350,4 +1350,4 @@ We would appreciate any feedback you may have!
 
 * Report any problems you face migrating to the new K2 compiler in [our issue tracker](https://youtrack.jetbrains.com/newIssue?project=KT&summary=K2+release+migration+issue&description=Describe+the+problem+you+encountered+here.&c=tag+k2-release-migration).
 * [Enable the Send usage statistics option](https://www.jetbrains.com/help/idea/settings-usage-statistics.html) to
-  allow JetBrains to collect anonymous data about K2 usage.
+  allow JetBrains to collect anonymous data about K2 usage.

docs/topics/multiplatform/multiplatform-compatibility-guide.md

@@ -406,7 +406,7 @@ Here's the planned deprecation cycle:
 
 * 1.9: introduce a deprecation warning for dependencies on legacy libraries
 * 2.0: raise the warning for dependencies on legacy libraries to an error
-* \>2.0: remove support for dependencies on legacy libraries; using such dependencies can cause build failures
+* >2.0: remove support for dependencies on legacy libraries; using such dependencies can cause build failures
 
 <anchor name="compilation-source-deprecation"/>
 ## Deprecated API for adding Kotlin source sets directly to the Kotlin compilation
@@ -472,7 +472,7 @@ Here's the planned deprecation cycle:
 
 * 1.9.0: introduce a deprecation warning when `KotlinComplation.source` is used
 * 1.9.20: raise this warning to an error
-* \>1.9.20: remove `KotlinComplation.source` from the Kotlin Gradle plugin, attempts to use it lead to "unresolved
+* &gt;1.9.20: remove `KotlinComplation.source` from the Kotlin Gradle plugin, attempts to use it lead to "unresolved
   reference" errors during the buildscript compilation
 
 <anchor name="kotlin-js-plugin-deprecation"/>
@@ -787,7 +787,7 @@ Here's the planned deprecation cycle:
 
 * 1.3.40: introduce a warning when `targetPresets.jvmWithJava` is used
 * 1.9.20: raise this warning to an error
-* \>1.9.20: remove `targetPresets.jvmWithJava` API; attempts to use it lead to the buildscript compilation failure
+* &gt;1.9.20: remove `targetPresets.jvmWithJava` API; attempts to use it lead to the buildscript compilation failure
 
 > Even though the whole `targetPresets` API is deprecated, the `jvmWithJava` preset has a different deprecation timeline.
 >
@@ -809,7 +809,7 @@ Here's the planned deprecation cycle:
 * <=1.9.0: report a warning when `kotlin.mpp.androidSourceSetLayoutVersion=1` is used; the warning can be suppressed with
   `kotlin.mpp.androidSourceSetLayoutVersion1.nowarn=true` Gradle property
 * 1.9.20: raise this warning to an error; the error **cannot** be suppressed
-* \>1.9.20: remove support for `kotlin.mpp.androidSourceSetLayoutVersion=1`; the Kotlin Gradle plugin ignores the property
+* &gt;1.9.20: remove support for `kotlin.mpp.androidSourceSetLayoutVersion=1`; the Kotlin Gradle plugin ignores the property
 
 <anchor name="common-sourceset-with-dependson-deprecation"/>
 ## Deprecated commonMain and commonTest with custom dependsOn
@@ -847,7 +847,7 @@ to `commonMain` and vice versa.
 Here's the planned deprecation cycle:
 
 * 1.9.0: report a warning when `dependsOn` is used in `commonMain`
-* \>=1.9.20: report an error when `dependsOn` is used in `commonMain` or `commonTest`
+* &gt;=1.9.20: report an error when `dependsOn` is used in `commonMain` or `commonTest`
 
 <anchor name="target-presets-deprecation"/>
 ## Deprecated target presets API
@@ -905,7 +905,7 @@ Here's the planned deprecation cycle:
 
 * 1.9.20: report a warning on any usages of the presets-related API
 * 2.0: raise this warning to an error
-* \>2.0: remove the presets-related API from the public API of the Kotlin Gradle plugin; sources that still use it fail
+* &gt;2.0: remove the presets-related API from the public API of the Kotlin Gradle plugin; sources that still use it fail
   with "unresolved reference" errors, and binaries (for example, Gradle plugins) might fail with linkage errors
   unless recompiled against the latest versions of the Kotlin Gradle plugin
 
@@ -1002,4 +1002,4 @@ version of the iOS framework. So, the changes won't be visible in the iOS app in
 We're planning to fix this issue in Kotlin 2.0.10. You can check if any preview versions of
 Kotlin 2.0.10 are already available in the [Participate in the Kotlin Early Access Preview](eap.md) section.
 
-For more information, see the [corresponding issue in YouTrack](https://youtrack.jetbrains.com/issue/KT-68257).
+For more information, see the [corresponding issue in YouTrack](https://youtrack.jetbrains.com/issue/KT-68257).

docs/topics/whatsnew17.md

@@ -525,7 +525,7 @@ compatibility, see [Compatibility modes](compatibility-modes.md).
 
 ### Access to annotations via reflection
 
-The `KAnnotatedElement.[findAnnotations()](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.reflect.full/find-annotations.html)`
+The [`KAnnotatedElement.findAnnotations()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.reflect.full/find-annotations.html)
 extension function, which was first [introduced in 1.6.0](whatsnew16.md#repeatable-annotations-with-runtime-retention-for-1-8-jvm-target),
 is now [Stable](components-stability.md). This [reflection](reflection.md)
 function returns all annotations of a given type on an element, including individually applied and repeated annotations.