Update README and fix gemspec for 1.0 release.

Expand README with project motivation, quick start example, and links
to full documentation. Fix gemspec to reference CHANGES.md (not CHANGES)
and correct test_files glob pattern.

Author: cfis

README.md

@@ -1,24 +1,58 @@
 # ruby-bindgen
 
-Generate Ruby bindings from C and C++ headers.
+Wrapping C and C++ libraries by hand for use in Ruby has traditionally been a long, arduous task. For large, complex libraries it can take months. As a result, many C/C++ libraries are either never exposed to Ruby or their bindings quickly become outdated, especially in scientific and technical domains.
 
-## Prerequisites
+`ruby-bindgen's` solves this problem by automatically creating bindings from C and C++ header files. It can even generate a CMake build system if needed. It has been battle tested against large C/C++ libraries such as Proj and OpenCv.
 
-- Ruby 3.2 or later
-- libclang (provided by LLVM/Clang)
+For much more information read the extensive [documenation](https://ruby-rice.github.io/ruby-bindgen/).
+
+## Quick Start
+
+Create a config file (`rice-bindings.yaml`):
+
+```yaml
+project: my_extension
+input: ./include
+output: ./ext/generated
+format: Rice
+
+match:
+  - "**/*.hpp"
+
+clang:
+  args:
+    - -I./include
+    - -std=c++17
+    - -xc++
+```
+
+Generate bindings:
+
+```bash
+ruby-bindgen rice-bindings.yaml
+```
+
+This produces `.cpp`, `.hpp`, and `.ipp` files ready to compile as a Ruby extension.
 
 ## Install
 
 ```console
 gem install ruby-bindgen
 ```
 
-## Run
+## Requirements
 
-```bash
-ruby-bindgen config.yaml
-```
+- Ruby 3.2+
+- libclang (provided by LLVM/Clang)
 
 ## Documentation
 
-Documentation is at [ruby-rice.github.io/ruby-bindgen](https://ruby-rice.github.io/ruby-bindgen/).
+Full documentation is at [ruby-rice.github.io/ruby-bindgen](https://ruby-rice.github.io/ruby-bindgen/).
+
+- [C++ (Rice) Getting Started](https://ruby-rice.github.io/ruby-bindgen/cpp/getting_started/)
+- [C (FFI) Getting Started](https://ruby-rice.github.io/ruby-bindgen/c/getting_started/)
+- [Configuration Reference](https://ruby-rice.github.io/ruby-bindgen/configuration/)
+
+## License
+
+BSD-2-Clause

ruby-bindgen.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
 
   spec.metadata = {
     "bug_tracker_uri"   => "https://github.com/ruby-rice/ruby-bindgen/issues",
-    "changelog_uri"     => "https://github.com/ruby-rice/ruby-bindgen/blob/main/CHANGES",
+    "changelog_uri"     => "https://github.com/ruby-rice/ruby-bindgen/blob/main/CHANGES.md",
     "source_code_uri"   => "https://github.com/ruby-rice/ruby-bindgen/tree/v#{spec.version}",
   }
 
@@ -20,7 +20,7 @@ Gem::Specification.new do |spec|
   spec.require_path = "lib"
   spec.bindir = "bin"
   spec.executables = ["ruby-bindgen"]
-  spec.files = Dir['CHANGES',
+  spec.files = Dir['CHANGES.md',
                    'LICENSE',
                    'Rakefile',
                    'README.md',
@@ -30,7 +30,7 @@ Gem::Specification.new do |spec|
                    'lib/**/*',
 ]
 
-  spec.test_files = Dir["test/test_*.rb"]
+  spec.test_files = Dir["test/*_test.rb"]
   spec.required_ruby_version = '>= 3.2.0'
   spec.date = Time.now.strftime('%Y-%m-%d')
   spec.homepage = 'https://github.com/ruby-rice/ruby-bindgen'