chore: tour fixes

Author: sarahhaggarty

docs/topics/data-classes.md

@@ -10,10 +10,10 @@ data class User(val name: String, val age: Int)
 
 The compiler automatically derives the following members from all properties declared in the primary constructor:
 
-* `.equals()`/`.hashCode()` pair.
-* `.toString()` of the form `"User(name=John, age=42)"`.
-* [`.componentN()` functions](destructuring-declarations.md) corresponding to the properties in their order of declaration.
-* `.copy()` function (see below).
+* `equals()`/`hashCode()` pair.
+* `toString()` of the form `"User(name=John, age=42)"`.
+* [`componentN()` functions](destructuring-declarations.md) corresponding to the properties in their order of declaration.
+* `copy()` function (see below).
 
 To ensure consistency and meaningful behavior of the generated code, data classes have to fulfill the following requirements:
 
@@ -23,13 +23,13 @@ To ensure consistency and meaningful behavior of the generated code, data classe
 
 Additionally, the generation of data class members follows these rules with regard to the members' inheritance:
 
-* If there are explicit implementations of `.equals()`, `.hashCode()`, or `.toString()` in the data class body or
+* If there are explicit implementations of `equals()`, `hashCode()`, or `toString()` in the data class body or
   `final` implementations in a superclass, then these functions are not generated, and the existing
   implementations are used.
-* If a supertype has `.componentN()` functions that are `open` and return compatible types, the
+* If a supertype has `componentN()` functions that are `open` and return compatible types, the
   corresponding functions are generated for the data class and override those of the supertype. If the functions of the
   supertype cannot be overridden due to incompatible signatures or due to their being final, an error is reported.
-* Providing explicit implementations for the `.componentN()` and `.copy()` functions is not allowed.
+* Providing explicit implementations for the `componentN()` and `copy()` functions is not allowed.
 
 Data classes may extend other classes (see [Sealed classes](sealed-classes.md) for examples).
 
@@ -53,10 +53,10 @@ data class Person(val name: String) {
 }
 ```
 
-In the example below, only the `name` property is used by default inside the `.toString()`, `.equals()`, `.hashCode()`, 
-and `.copy()` implementations, and there is only one component function, `.component1()`. 
+In the example below, only the `name` property is used by default inside the `toString()`, `equals()`, `hashCode()`, 
+and `copy()` implementations, and there is only one component function, `component1()`. 
 The `age` property is declared inside the class body and is excluded.
-Therefore, two `Person` objects with the same `name` but different `age` values are considered equal since `.equals()` 
+Therefore, two `Person` objects with the same `name` but different `age` values are considered equal since `equals()` 
 only evaluates properties from the primary constructor:
 
 ```kotlin
@@ -85,7 +85,7 @@ fun main() {
 
 ## Copying
 
-Use the `.copy()` function to copy an object, allowing you to alter _some_ of its properties while keeping the rest unchanged.
+Use the `copy()` function to copy an object, allowing you to alter _some_ of its properties while keeping the rest unchanged.
 The implementation of this function for the `User` class above would be as follows:
 
 ```kotlin

docs/topics/gradle/gradle-configure-project.md

@@ -60,7 +60,7 @@ In the following table, there are the minimum and maximum **fully supported** ve
 | 1.7.0–1.7.10  | 6.7.1–7.0.2                            | 3.4.3–7.0.2                                         |
 | 1.6.20–1.6.21 | 6.1.1–7.0.2                            | 3.4.3–7.0.2                                         |
 
-> Kotlin 2.0.20 is fully compatible with Gradle 6.8.3 through 8.6.
+> *Kotlin 2.0.20 is fully compatible with Gradle 6.8.3 through 8.6.
 > Gradle 8.7 and 8.8 are also supported, with only one exception: If you use the Kotlin Multiplatform Gradle plugin,
 > you may see deprecation warnings in your multiplatform projects calling the [`withJava()` function in the JVM target](multiplatform-dsl-reference.md#jvm-targets).
 > For more information, see the issue in [YouTrack](https://youtrack.jetbrains.com/issue/KT-66542/Gradle-JVM-target-with-withJava-produces-a-deprecation-warning).

docs/topics/tour/kotlin-tour-classes.md

@@ -151,11 +151,11 @@ data class User(val name: String, val id: Int)
 
 The most useful predefined member functions of data classes are:
 
-| **Function**        | **Description**                                                                                                |
-|---------------------|----------------------------------------------------------------------------------------------------------------|
-| `.toString()`       | Prints a readable string of the class instance and its properties.                                             |
-| `.equals()` or `==` | Compares instances of a class.                                                                                 |
-| `.copy()`           | Creates a class instance by copying another, potentially with some different properties.                       |
+| **Function**       | **Description**                                                                          |
+|--------------------|------------------------------------------------------------------------------------------|
+| `toString()`       | Prints a readable string of the class instance and its properties.                       |
+| `equals()` or `==` | Compares instances of a class.                                                           |
+| `copy()`           | Creates a class instance by copying another, potentially with some different properties. |
 
 See the following sections for examples of how to use each function:
 
@@ -165,8 +165,8 @@ See the following sections for examples of how to use each function:
 
 ### Print as string
 
-To print a readable string of a class instance, you can explicitly call the `.toString()` function, or use print functions 
-(`println()` and `print()`) which automatically call `.toString()` for you:
+To print a readable string of a class instance, you can explicitly call the `toString()` function, or use print functions 
+(`println()` and `print()`) which automatically call `toString()` for you:
 
 ```kotlin
 data class User(val name: String, val id: Int)
@@ -212,9 +212,9 @@ fun main() {
 
 ### Copy instance
 
-To create an exact copy of a data class instance, call the `.copy()` function on the instance.
+To create an exact copy of a data class instance, call the `copy()` function on the instance.
 
-To create a copy of a data class instance **and** change some properties, call the `.copy()` function on the instance 
+To create a copy of a data class instance **and** change some properties, call the `copy()` function on the instance 
 **and** add replacement values for properties as function parameters.
 
 For example:
@@ -329,7 +329,7 @@ a fixed list of potential names (inside the class body). Configure the class wit
 the class header). In the class body, define the `generateEmployee()` function. Once again, the main function demonstrates
 how you can use this class.
 
-> In this exercise, you import a package so that you can use the `Random.nextInt()` function.
+> In this exercise, you import a package so that you can use the [`Random.nextInt()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.random/-random/next-int.html) function.
 > For more information about importing packages, see [Packages and imports](packages.md).
 >
 {type = "tip"}

docs/topics/tour/kotlin-tour-control-flow.md

@@ -238,8 +238,8 @@ fun main() {
 
 ### Exercise 2 {initial-collapse-state="collapsed" id="conditional-expressions-exercise-2"}
 
-Using a `when` expression, update the following program so that when you input the names of GameBoy buttons, the actions
-are printed as output.
+Using a `when` expression, update the following program so that it prints the corresponding actions when you input the 
+names of game console buttons.
 
 | **Button** | **Action**             |
 |------------|------------------------|

docs/topics/whatsnew2020.md

@@ -29,9 +29,9 @@ receivers feature.
 
 ### Data class copy function to have the same visibility as constructor
 
-Currently, if you create a data class using a `private` constructor, the automatically generated `.copy()` function doesn't
+Currently, if you create a data class using a `private` constructor, the automatically generated `copy()` function doesn't
 have the same visibility. This can cause problems later in your code. In future Kotlin releases, we will introduce the
-behavior that the default visibility of the `.copy()` function is the same as the constructor. This change will be
+behavior that the default visibility of the `copy()` function is the same as the constructor. This change will be
 introduced gradually to help you migrate your code as smoothly as possible.
 
 Our migration plan starts with Kotlin 2.0.20, which issues warnings in your code where the visibility will
@@ -60,7 +60,7 @@ To give you more control over this behavior, in Kotlin 2.0.20 we've introduced t
 
 * `@ConsistentCopyVisibility` to opt in to the behavior now before we make it the default in a later release.
 * `@ExposedCopyVisibility` to opt out of the behavior and suppress warnings at the declaration site.
-  Note that even with this annotation, the compiler still reports warnings when the `.copy()` function is called.
+  Note that even with this annotation, the compiler still reports warnings when the `copy()` function is called.
 
 If you want to opt in to the new behavior already in 2.0.20 for a whole module rather than in individual classes,
 you can use the `-Xconsistent-data-class-copy-visibility` compiler option.