docs: Refine benchmarking-overview and benchmark-runtime docs for clarity and relevance

Author: wldeh

docs/benchmark-runtime.md

@@ -23,3 +23,35 @@ The benchmark configuration is handled through annotations that map directly to
 ### File Operations
 
 File reading and writing operations are performed using standard Java I/O classes, providing a consistent and reliable method for file operations across all JVM platforms.
+
+## JavaScript Target
+
+The JavaScript target in kotlinx.benchmark leverages the Benchmark.js library to run benchmarks. Benchmark.js is a robust tool for executing JavaScript benchmarks in different environments, including browsers and Node.js.
+
+### Benchmark Execution
+
+Benchmark.js handles the execution of benchmarks, managing the setup, running, and teardown of tests. Just like JMH for JVM, it also handles the calculation of results, providing a reliable framework for benchmarking on JavaScript.
+
+### Benchmark Configuration
+
+The benchmark configuration in JavaScript is handled through a suite and benchmark API provided by benchmark.js. The API allows the users to specify the details of the benchmark such as the function to benchmark, setup function, and teardown function.
+
+### File Operations
+
+File reading and writing operations in JavaScript are performed using the standard JavaScript file I/O APIs. This includes the fs module in Node.js or the File API in browsers.
+
+## Native Target
+
+The Native target in kotlinx.benchmark leverages the built-in benchmarking capabilities of the Kotlin/Native runtime to execute benchmarks.
+
+### Benchmark Execution
+
+Kotlin/Native manages the execution of benchmarks, handling the setup, running, and teardown of tests. Just like JMH for JVM and Benchmark.js for JavaScript, Kotlin/Native also takes care of the calculation of results, providing a reliable framework for benchmarking in a native environment.
+
+### Benchmark Configuration
+
+The benchmark configuration in Kotlin/Native is handled through annotations that are similar to those used in the JVM target. These include `@State`, `@Benchmark`, `@BenchmarkMode`, `@OutputTimeUnit`, `@Warmup`, `@Measurement`, and `@Param`.
+
+### File Operations
+
+File operations in the Native target are handled through Kotlin's standard file I/O APIs. These APIs are compatible with all platforms supported by Kotlin/Native, providing a consistent method for file operations.

docs/benchmarking-overview.md

@@ -1,4 +1,4 @@
-# Harnessing Code Performance: The Art and Science of Benchmarking with kotlinx-benchmark
+# Code Benchmarking: A Brief Overview
 
 This guide serves as your compass for mastering the art of benchmarking with kotlinx-benchmark. By harnessing the power of benchmarking, you can unlock performance insights in your code, uncover bottlenecks, compare different implementations, detect regressions, and make informed decisions for optimization. 
 
@@ -47,8 +47,6 @@ Benchmarking provides several benefits for software development projects:
 
 4. **Hardware and Environment Variations:** Benchmarking helps evaluate the impact of different hardware configurations, system setups, or environments on performance. It enables developers to optimize their software for specific target platforms.
 
- comparison across systems. This eases sharing and discussing performance results within a team or the larger community.
-
 ## Benchmarking Use Cases
 
 Benchmarking serves as a critical tool across various scenarios in software development. Here are a few notable use cases: