Allow multiple benchmarks per folder in ruby-bench

Author: rafaelfranca

README.md

@@ -101,6 +101,33 @@ It's also convenient for profiling, debugging, etc, especially since all benchma
 ruby benchmarks/some_benchmark.rb
 ```
 
+### Benchmark organization
+
+Benchmarks can be organized in three ways:
+
+1. **Standalone .rb files** - Place a `.rb` file directly in the `benchmarks/` directory:
+   ```
+   benchmarks/fib.rb         # Benchmark name: "fib"
+   ```
+
+2. **Single benchmark per directory** - For benchmarks that need additional files (like Gemfiles):
+   ```
+   benchmarks/erubi/
+     benchmark.rb            # Benchmark name: "erubi"
+     Gemfile
+   ```
+
+3. **Multiple benchmarks per directory** - For related benchmarks sharing dependencies:
+   ```
+   benchmarks/addressable/
+     benchmark-equality.rb   # Benchmark name: "addressable-equality"
+     benchmark-join.rb       # Benchmark name: "addressable-join"
+     Gemfile                 # Shared Gemfile
+   ```
+   
+   All files matching `benchmark*.rb` in a directory will be discovered. The benchmark
+   name is derived as `directoryname-suffix` from `benchmark-suffix.rb` files.
+
 ## Ractor Benchmarks
 
 ruby-bench supports Ractor-specific benchmarking with dedicated categories and benchmark directories.