Move detailed documentation from README to docs/

- Move Documentation Options table to docs/documentation-options.md
- Simplify Development and Contributing sections to reference docs/
- Keep README focused on quick start examples

Author: numbata

README.md

@@ -10,10 +10,6 @@
 - [Compatibility](#compatibility)
 - [Installation](#installation)
 - [Usage](#usage)
-  - [Basic Entity](#basic-entity)
-  - [Custom Model Description](#custom-model-description)
-  - [Entity References](#entity-references)
-  - [Documentation Options](#documentation-options)
 - [Development](#development)
 - [Contributing](#contributing)
 - [License](#license)
@@ -124,35 +120,17 @@ end
 
 ### Documentation Options
 
-The following options are available in the `documentation` hash:
-
-| Option | Description |
-|--------|-------------|
-| `type` | OpenAPI data type (`String`, `Integer`, `Boolean`, etc.) |
-| `desc` | Property description |
-| `required` | Whether field is required (default: based on expose options) |
-| `is_array` | Marks field as array type |
-| `read_only` | Marks field as read-only |
-| `values` | Enum values for the field |
-| `example` | Example value |
-| `default` | Default value |
-| `minimum` | Minimum value for numeric types |
-| `maximum` | Maximum value for numeric types |
-| `min_length` | Minimum length for string types |
-| `max_length` | Maximum length for string types |
-| `hidden` | Hide field from documentation |
+Common options: `type`, `desc`, `required`, `is_array`, `values`, `example`.
 
-## Development
+See [full documentation options](docs/documentation-options.md) for all available options including validation constraints.
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rspec` to run the tests. You can also run `bin/pry` for an interactive prompt that will allow you to experiment.
+## Development
 
-To install this gem onto your local machine, run `bundle exec rake install`.
+See [testing documentation](docs/testing.md) for development setup and running tests.
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/ruby-grape/grape-swagger-entity.
-
-See [CONTRIBUTING](CONTRIBUTING.md) for more information.
+See [contributing guidelines](docs/contributing.md).
 
 ## License
 

docs/documentation-options.md

@@ -0,0 +1,86 @@
+# Documentation Options
+
+The `documentation` hash in entity exposures supports the following options:
+
+## Type Options
+
+| Option | Description | Example |
+|--------|-------------|---------|
+| `type` | OpenAPI data type | `String`, `Integer`, `Boolean`, `Float`, `Date`, `DateTime` |
+| `is_array` | Marks field as array type | `true` / `false` |
+
+## Description Options
+
+| Option | Description | Example |
+|--------|-------------|---------|
+| `desc` | Property description | `'User email address'` |
+| `example` | Example value for documentation | `'user@example.com'` |
+| `default` | Default value | `'pending'` |
+
+## Validation Options
+
+| Option | Description | Example |
+|--------|-------------|---------|
+| `required` | Whether field is required | `true` / `false` |
+| `values` | Enum values (array or proc) | `%w[pending active]` or `-> { Status.all }` |
+| `minimum` | Minimum value for numeric types | `0` |
+| `maximum` | Maximum value for numeric types | `100` |
+| `min_length` | Minimum length for strings | `1` |
+| `max_length` | Maximum length for strings | `255` |
+
+## Display Options
+
+| Option | Description | Example |
+|--------|-------------|---------|
+| `read_only` | Marks field as read-only | `true` |
+| `hidden` | Hide field from documentation | `true` |
+
+## Examples
+
+### Basic types
+
+```ruby
+expose :id, documentation: { type: Integer, desc: 'Unique identifier' }
+expose :name, documentation: { type: String, desc: 'Full name', required: true }
+expose :active, documentation: { type: Boolean, default: true }
+```
+
+### Enums
+
+```ruby
+expose :status, documentation: {
+  type: String,
+  desc: 'Current status',
+  values: %w[pending active suspended]
+}
+```
+
+### Numeric constraints
+
+```ruby
+expose :age, documentation: {
+  type: Integer,
+  minimum: 0,
+  maximum: 150
+}
+```
+
+### String constraints
+
+```ruby
+expose :username, documentation: {
+  type: String,
+  min_length: 3,
+  max_length: 20
+}
+```
+
+### Arrays
+
+```ruby
+expose :tags, documentation: {
+  type: String,
+  is_array: true,
+  desc: 'Associated tags'
+}
+```