update: final tutorial revamp (#4748)

Author: danil-pavlov

docs/topics/native/mapping-function-pointers-from-c.md

@@ -1,17 +1,16 @@
 [//]: # (title: Mapping function pointers from C – tutorial)
 
 <tldr>
-    <p>This is the third part of the <strong>Mapping Kotlin and C</strong> tutorial series.</p>
+    <p>This is the third part of the <strong>Mapping Kotlin and C</strong> tutorial series. Before proceeding, make sure you've completed the previous steps.</p>
     <p><img src="icon-1-done.svg" width="20" alt="First step"/> <a href="mapping-primitive-data-types-from-c.md">Mapping primitive data types from C</a><br/>
         <img src="icon-2-done.svg" width="20" alt="Second step"/> <a href="mapping-struct-union-types-from-c.md">Mapping struct and union types from C</a><br/>
         <img src="icon-3.svg" width="20" alt="Third step"/> <strong>Mapping function pointers</strong><br/>
         <img src="icon-4-todo.svg" width="20" alt="Fourth step"/> <a href="mapping-strings-from-c.md">Mapping strings from C</a><br/>
     </p>
 </tldr>
 
-> The C libraries import is [Experimental](components-stability.md#stability-levels-explained).
-> All Kotlin declarations generated by the `cinterop` tool from C libraries
-> should have the `@ExperimentalForeignApi` annotation.
+> The C libraries import is [Experimental](components-stability.md#stability-levels-explained). All Kotlin declarations
+> generated by the cinterop tool from C libraries should have the `@ExperimentalForeignApi` annotation.
 >
 > Native platform libraries shipped with Kotlin/Native (like Foundation, UIKit, and POSIX)
 > require opt-in only for some APIs.
@@ -75,7 +74,7 @@ Let's see how C function pointers are mapped into Kotlin/Native and update your
    }
    ```
 
-2. Use the IntelliJ IDEA's [Go to declaration](https://www.jetbrains.com/help/rider/Navigation_and_Search__Go_to_Declaration.html)
+2. Use IntelliJ IDEA's [Go to declaration](https://www.jetbrains.com/help/rider/Navigation_and_Search__Go_to_Declaration.html)
    command (<shortcut>Cmd + B</shortcut>/<shortcut>Ctrl + B</shortcut>) to navigate to the following generated API
    for C functions:
 
@@ -134,7 +133,7 @@ fun myFun2() {
 
 Kotlin turns the function pointer return type into a nullable `CPointer<CFunction<>` object. You need to first explicitly
 check for `null`, which is why the [Elvis operator](null-safety.md) is used in the code above.
-The `cinterop` tool allows you to call a C function pointer as a regular Kotlin function call: `functionFromC(42)`.
+The cinterop tool allows you to call a C function pointer as a regular Kotlin function call: `functionFromC(42)`.
 
 ## Update Kotlin code
 
@@ -159,7 +158,7 @@ fun main() {
 }
 ```
 
-To verify that everything works as expected, run the `runDebugExecutableNative` Gradle task [in IDE](native-get-started.md#build-and-run-the-application)
+To verify that everything works as expected, run the `runDebugExecutableNative` Gradle task [in your IDE](native-get-started.md#build-and-run-the-application)
 or use the following command to run the code:
 
 ```bash

docs/topics/native/mapping-primitive-data-types-from-c.md

@@ -9,9 +9,8 @@
     </p>
 </tldr>
 
-> The C libraries import is [Experimental](components-stability.md#stability-levels-explained).
-> All Kotlin declarations generated by the `cinterop` tool from C libraries
-> should have the `@ExperimentalForeignApi` annotation.
+> The C libraries import is [Experimental](components-stability.md#stability-levels-explained). All Kotlin declarations
+> generated by the cinterop tool from C libraries should have the `@ExperimentalForeignApi` annotation.
 >
 > Native platform libraries shipped with Kotlin/Native (like Foundation, UIKit, and POSIX)
 > require opt-in only for some APIs.
@@ -89,7 +88,7 @@ To create a C library:
    headers = lib.h
    ```
 
-4. It can be helpful to include macros or other C definitions in the code generated by the `cinterop` tool. This way,
+4. It can be helpful to include macros or other C definitions in the code generated by the cinterop tool. This way,
    method bodies are also compiled and fully included in the binary. With this feature, you can create a runnable example
    without needing a C compiler.
 
@@ -220,7 +219,7 @@ You'll complete the code later as you learn how C primitive type declarations lo
 
 Let's see how C primitive types are mapped into Kotlin/Native and update the example project accordingly.
 
-Use the IntelliJ IDEA's [Go to declaration](https://www.jetbrains.com/help/rider/Navigation_and_Search__Go_to_Declaration.html)
+Use IntelliJ IDEA's [Go to declaration](https://www.jetbrains.com/help/rider/Navigation_and_Search__Go_to_Declaration.html)
 command (<shortcut>Cmd + B</shortcut>/<shortcut>Ctrl + B</shortcut>) to navigate to the following generated API
 for C functions: