rage_flip 1.0.1 → 1.2.0

data/README.md

@@ -1,222 +1,744 @@
-# RageFlip
+# RageFlip# RageFlip
 
-`rage_flip` is a Ruby gem that provides text manipulation utilities with clipboard integration. It flips text upside down with rage table flip emoticons and includes several other text formatting tools.
 
-## Installation
 
-Add this line to your application's Gemfile:
+`rage_flip` is a comprehensive Ruby gem that provides text manipulation utilities with clipboard integration. It flips text upside down with rage table flip emoticons, includes extensive text formatting tools, and features a rich collection of emotes and text substitutions for enhanced communication.`rage_flip` is a Ruby gem that provides text manipulati### emote
 
-```ruby
-gem 'rage_flip'
-```
 
-And then execute:
 
-```bash
-bundle install
+## InstallationThe emote system provides a comprehensive collection of emoticons, text substitutions, and emoji sequences:
+
+
+
+Add this line to your application's Gemfile:```bash
+
+emote                    # List all available emotes
+
+```rubyemote list               # List all available emotes  
+
+gem 'rage_flip'emote disapproval        # Output: (ಠ_ಠ)
+
+```emote rage               # Output: ಠ益ಠ
+
+emote flip               # Output: (╯°□°)╯︵ ┻━┻
+
+And then execute:emote rageflip           # Output: (ノಠ益ಠ)ノ彡┻━┻
+
+emote shrug              # Output: ¯\_(ツ)_/¯
+
+```bashemote fu                 # Output: t(-__-t)
+
+bundle installemote facepalm           # Output: (－‸ლ)
+
+```emote rock               # Output: \m/ (>_<) \m/
+
 ```
 
 Or install it yourself as:
 
-```bash
-gem install rage_flip
-```
+#### Shit Emotes
 
-## Usage
+```bashVarious poop emoji combinations:
 
-The gem provides several command-line utilities for text manipulation:
+gem install rage_flip```bash
+
+```emote bullshit           # Output: 🐄💩
+
+emote catshit            # Output: 🐱💩
+
+## Usageemote dogshit            # Output: 🐶💩
+
+emote pandashit          # Output: 🐼💩
+
+The gem provides several command-line utilities for text manipulation:emote horseshit          # Output: 🐴💩
+
+emote koalashit          # Output: 🐨💩
 
-### rage_flip
+### rage_flipemote batshit            # Output: 🦇💩
+
+```
 
 The main command flips text upside down and adds rage table flip emoticons:
 
+#### Text Substitutions
+
+```bashKeyboard shortcuts and symbols:
+
+rage_flip "Hello World"```bash
+
+# Output: (ノಠ益ಠ)ノ彡┻plɹoM ollǝH┻  emote cmd                # Output: ⌘
+
+# Result is automatically copied to clipboardemote command            # Output: ⌘
+
+```emote cmd-               # Output: ⌘-
+
+emote optn               # Output: ⌥
+
+The flip transformation:emote option             # Output: ⌥
+
+- Reverses the text orderemote cntl               # Output: ⌃
+
+- Maps characters to their upside-down equivalentsemote shft               # Output: ⇧
+
+- Wraps the result with `(ノಠ益ಠ)ノ彡┻` and `┻`emote shift              # Output: ⇧
+
+```
+
+### table_flip
+
+#### Special Emotes
+
+The classic table flip command flips text upside down with the iconic table flip emoticons:Multi-line and unique expressions:
+
 ```bash
-rage_flip "Hello World"
-# Output: (ノಠ益ಠ)ノ彡┻plɹoM ollǝH┻  
+
+```bashemote kungfuhamster      # Output: Multi-line ASCII hamster
+
+table_flip "Hello World"emote noevil             # Output: 🙈🙉🙊
+
+# Output: (╯°□°)╯︵ plɹoM ollǝH ┻━┻emote omw                # Output: On my way!
+
+# Result is automatically copied to clipboardemote bugeyes            # Output: (⊙_◎)
+
+```emote dogshrug           # Output: ¯\_🐶_/¯
+
+emote javaflip           # Output: (╯°□°)╯︵ ┻ɐʌɐɾ┻
+
+Uses the classic `(╯°□°)╯︵` and `┻━┻` emoticons for a more traditional table flip style.emote heresatable        # Output: ┬─┬ ノ( ゜-゜ノ)
+
+emote shrugtable         # Output: ┻━┻ ︵ ¯\(ツ)/¯ ︵ ┻━┻
+
+### flip_textemote unsee              # Output: ♨_♨
+
+emote yuno               # Output: ლ(ಠ益ಠლ)
+
+Flips text upside down without any emoticons:```
+
+
+
+```bashAll emotes are accessed through the `emote` command followed by the emote name. Use `emote list` to see the complete collection of available emotes. clipboard integration. It flips text upside down with rage table flip emoticons and includes several other text formatting tools.
+
+flip_text "Hello World"
+
+# Output: plɹoM ollǝH## Installation
+
 # Result is automatically copied to clipboard
+
+```Add this line to your application's Gemfile:
+
+
+
+Just the pure flipped text without any rage or table flip decorations.```ruby
+
+gem 'rage_flip'
+
+### emote```
+
+
+
+The emote system provides a comprehensive collection of emoticons, text substitutions, and emoji sequences:And then execute:
+
+
+
+```bash```bash
+
+emote                    # List all available emotesbundle install
+
+emote list               # List all available emotes  ```
+
+emote disapproval        # Output: (ಠ_ಠ)
+
+emote rage               # Output: ಠ益ಠOr install it yourself as:
+
+emote flip               # Output: (╯°□°)╯︵ ┻━┻
+
+emote rageflip           # Output: (ノಠ益ಠ)ノ彡┻━┻```bash
+
+emote shrug              # Output: ¯\_(ツ)_/¯gem install rage_flip
+
+emote fu                 # Output: t(-__-t)```
+
+emote facepalm           # Output: (－‸ლ)
+
+emote rock               # Output: \m/ (>_<) \m/## Usage
+
 ```
 
-The flip transformation:
-- Reverses the text order
-- Maps characters to their upside-down equivalents
-- Wraps the result with `(ノಠ益ಠ)ノ彡┻` and `┻`
+The gem provides several command-line utilities for text manipulation:
 
-### sarcasm
+#### Shit Emotes
 
-Alternates between uppercase and lowercase characters:
+Various poop emoji combinations:### rage_flip
 
 ```bash
-sarcasm "this is sarcastic"
-# Output: ThIs Is SaRcAsTiC
+
+emote bullshit           # Output: 🐄💩The main command flips text upside down and adds rage table flip emoticons:
+
+emote catshit            # Output: 🐱💩
+
+emote dogshit            # Output: 🐶💩```bash
+
+emote pandashit          # Output: 🐼💩rage_flip "Hello World"
+
+emote horseshit          # Output: 🐴💩# Output: (ノಠ益ಠ)ノ彡┻plɹoM ollǝH┻  
+
+emote koalashit          # Output: 🐨💩# Result is automatically copied to clipboard
+
+emote batshit            # Output: 🦇💩```
+
 ```
 
-### strikethrough
+The flip transformation:
 
-Adds strikethrough formatting to text using Unicode combining characters:
+#### Text Substitutions- Reverses the text order
+
+Keyboard shortcuts and symbols:- Maps characters to their upside-down equivalents
+
+```bash- Wraps the result with `(ノಠ益ಠ)ノ彡┻` and `┻`
+
+emote cmd                # Output: ⌘
+
+emote command            # Output: ⌘### table_flip
+
+emote cmd-               # Output: ⌘-
+
+emote optn               # Output: ⌥The classic table flip command flips text upside down with the iconic table flip emoticons:
+
+emote option             # Output: ⌥
+
+emote cntl               # Output: ⌃```bash
+
+emote shft               # Output: ⇧table_flip "Hello World"
+
+emote shift              # Output: ⇧# Output: (╯°□°)╯︵ plɹoM ollǝH ┻━┻
+
+```# Result is automatically copied to clipboard
 
-```bash
-strikethrough "crossed out text"
-# Output: c̶r̶o̶s̶s̶e̶d̶ ̶o̶u̶t̶ ̶t̶e̶x̶t̶
 ```
 
-### underline
+#### Special Emotes
 
-Adds single underline formatting:
+Multi-line and unique expressions:Uses the classic `(╯°□°)╯︵` and `┻━┻` emoticons for a more traditional table flip style.
 
 ```bash
-underline "underlined text"
-# Output: u̲n̲d̲e̲r̲l̲i̲n̲e̲d̲ ̲t̲e̲x̲t̲
-```
 
-### doubleunderline
+emote kungfuhamster      # Output: Multi-line ASCII hamster### flip_text
+
+emote noevil             # Output: 🙈🙉🙊
+
+emote omw                # Output: On my way!Flips text upside down without any emoticons:
+
+emote bugeyes            # Output: (⊙_◎)
+
+emote dogshrug           # Output: ¯\_🐶_/¯```bash
+
+emote javaflip           # Output: (╯°□°)╯︵ ┻ɐʌɐɾ┻flip_text "Hello World"
+
+emote heresatable        # Output: ┬─┬ ノ( ゜-゜ノ)# Output: plɹoM ollǝH
+
+emote shrugtable         # Output: ┻━┻ ︵ ¯\(ツ)/¯ ︵ ┻━┻# Result is automatically copied to clipboard
+
+emote unsee              # Output: ♨_♨```
+
+emote yuno               # Output: ლ(ಠ益ಠლ)
+
+```Just the pure flipped text without any rage or table flip decorations.
+
+
+
+All emotes are accessed through the `emote` command followed by the emote name. Use `emote list` to see the complete collection of available emotes.### emote
+
 
-Adds double underline formatting:
+
+### sarcasmThe emote system provides various emoticons and emoji sequences:
+
+
+
+Alternates between uppercase and lowercase characters:```bash
+
+emote                    # List all available emotes
+
+```bashemote list               # List all available emotes  
+
+sarcasm "this is sarcastic"emote disapproval        # Output: (ಠ_ಠ)
+
+# Output: ThIs Is SaRcAsTiCemote bullshit           # Output: 🐄💩
+
+```emote catshit            # Output: �💩
+
+emote dogshit            # Output: �💩
+
+### strikethroughemote pandashit          # Output: 🐼💩
+
+emote horseshit          # Output: 🐴💩
+
+Adds strikethrough formatting to text using Unicode combining characters:emote batshit            # Output: 🦇💩
+
+```
 
 ```bash
-doubleunderline "double underlined"
+
+strikethrough "crossed out text"All emotes are accessed through the `emote` command followed by the emote name.
+
+# Output: c̶r̶o̶s̶s̶e̶d̶ ̶o̶u̶t̶ ̶t̶e̶x̶t̶
+
+```### sarcasm
+
+
+
+### underlineAlternates between uppercase and lowercase characters:
+
+
+
+Adds single underline formatting:```bash
+
+sarcasm "this is sarcastic"
+
+```bash# Output: ThIs Is SaRcAsTiC
+
+underline "underlined text"```
+
+# Output: u̲n̲d̲e̲r̲l̲i̲n̲e̲d̲ ̲t̲e̲x̲t̲
+
+```### strikethrough
+
+
+
+### doubleunderlineAdds strikethrough formatting to text using Unicode combining characters:
+
+
+
+Adds double underline formatting:```bash
+
+strikethrough "crossed out text"
+
+```bash# Output: c̶r̶o̶s̶s̶e̶d̶ ̶o̶u̶t̶ ̶t̶e̶x̶t̶
+
+doubleunderline "double underlined"```
+
 # Output: d̳o̳u̳b̳l̳e̳ ̳u̳n̳d̳e̳r̳l̳i̳n̳e̳d̳
-```
 
-### chaos
+```### underline
 
-Adds random Unicode combining characters for a chaotic effect:
 
-```bash
-chaos "chaotic text"
+
+### chaosAdds single underline formatting:
+
+
+
+Adds random Unicode combining characters for a chaotic effect:```bash
+
+underline "underlined text"
+
+```bash# Output: u̲n̲d̲e̲r̲l̲i̲n̲e̲d̲ ̲t̲e̲x̲t̲
+
+chaos "chaotic text"```
+
 # Output: c̸̰̈h̴̲̆a̷̰̋ò̶̰ẗ̸̲ḭ̷̋c̶̰̈ ̸̰̈t̷̰̋ĕ̴̲ẍ̸̰t̷̰̋
-```
 
-The chaos level is persistently stored in `~/.chaos_level.txt` and can be controlled with the `chaos_level` command.
+```### doubleunderline
+
+
 
-### chaos_level
+The chaos level is persistently stored in `~/.chaos_level.txt` and can be controlled with the `chaos_level` command.Adds double underline formatting:
 
-Controls the chaos level for the chaos command:
+
+
+### chaos_level```bash
+
+doubleunderline "double underlined"
+
+Controls the chaos level for the chaos command:# Output: d̳o̳u̳b̳l̳e̳ ̳u̳n̳d̳e̳r̳l̳i̳n̳e̳d̳
+
+```
 
 ```bash
-chaos_level         # Show current chaos level
+
+chaos_level         # Show current chaos level### chaos
+
 chaos_level show    # Show current chaos level  
-chaos_level more    # Increase chaos level by 1
+
+chaos_level more    # Increase chaos level by 1Adds random Unicode combining characters for a chaotic effect:
+
 chaos_level less    # Decrease chaos level by 1
+
+chaos_level 15      # Set chaos level to 15```bash
+
+```chaos "chaotic text"
+
+# Output: c̸̰̈h̴̲̆a̷̰̋ò̶̰ẗ̸̲ḭ̷̋c̶̰̈ ̸̰̈t̷̰̋ĕ̴̲ẍ̸̰t̷̰̋
+
+The default chaos level is 10. Higher numbers create more chaotic effects.```
+
+
+
+## Platform-Specific Clipboard SupportThe chaos level is persistently stored in `~/.chaos_level.txt` and can be controlled with the `chaos_level` command.
+
+
+
+The gem automatically detects your platform and uses the appropriate clipboard command:### chaos_level
+
+
+
+- **macOS**: Uses `pbcopy`Controls the chaos level for the chaos command:
+
+- **Linux**: Uses `xclip` or `xsel` (install one of these first)
+
+- **Windows**: Uses `clip````bash
+
+chaos_level         # Show current chaos level
+
+All commands automatically copy their output to the clipboard and display the result.chaos_level show    # Show current chaos level  
+
+chaos_level more    # Increase chaos level by 1
+
+## Character Mappingschaos_level less    # Decrease chaos level by 1
+
 chaos_level 15      # Set chaos level to 15
-```
 
-The default chaos level is 10. Higher numbers create more chaotic effects.
+The flip functionality uses comprehensive character mappings including:```
 
-## Platform-Specific Clipboard Support
+
+
+- Regular alphabet (A-Z, a-z)The default chaos level is 10. Higher numbers create more chaotic effects.
+
+- Numbers (0-9)
+
+- Common punctuation and symbols## Platform-Specific Clipboard Support
+
+- Special Unicode characters for upside-down equivalents
 
 The gem automatically detects your platform and uses the appropriate clipboard command:
 
+## Comprehensive Emote Collection
+
 - **macOS**: Uses `pbcopy`
-- **Linux**: Uses `xclip` or `xsel` (install one of these first)
+
+The gem includes an extensive collection of emotes organized into categories:- **Linux**: Uses `xclip` or `xsel` (install one of these first)
+
 - **Windows**: Uses `clip`
 
-All commands automatically copy their output to the clipboard and display the result.
+### Rage & Flipping
+
+- `disapproval`, `rage`, `flip`, `rageflip`, `javaflip`, `shrugtable`All commands automatically copy their output to the clipboard and display the result.
+
 
-## Character Mappings
+
+### Expressions & Gestures  ## Character Mappings
+
+- `shrug`, `fu`, `facepalm`, `rock`, `bugeyes`, `dogshrug`, `yuno`
 
 The flip functionality uses comprehensive character mappings including:
 
-- Regular alphabet (A-Z, a-z)
+### Poop Emotes
+
+- `bullshit`, `catshit`, `dogshit`, `pandashit`, `horseshit`, `koalashit`, `batshit`- Regular alphabet (A-Z, a-z)
+
 - Numbers (0-9)
-- Common punctuation and symbols
-- Special Unicode characters for upside-down equivalents
 
-## Persistent Settings
+### Keyboard Symbols- Common punctuation and symbols
 
-- **Chaos Level**: Stored in `~/.chaos_level.txt` and controls the intensity of the chaos effect (default: 10). This setting persists across terminal sessions and system reboots.
+- `cmd`/`command` (⌘), `optn`/`option` (⌥), `cntl` (⌃), `shft`/`shift` (⇧), `cmd-` (⌘-)- Special Unicode characters for upside-down equivalents
+
+
+
+### Special Characters## Comprehensive Emote Collection
+
+- `noevil` (🙈🙉🙊), `omw` ("On my way!"), `heresatable`, `kungfuhamster` (ASCII art), `unsee`
+
+The gem includes an extensive collection of emotes organized into categories:
+
+Use `emote list` to see all available emotes with their outputs.
+
+### Rage & Flipping
+
+## Persistent Settings- `disapproval`, `rage`, `flip`, `rageflip`, `javaflip`, `shrugtable`
+
+
+
+- **Chaos Level**: Stored in `~/.chaos_level.txt` and controls the intensity of the chaos effect (default: 10). This setting persists across terminal sessions and system reboots.### Expressions & Gestures  
+
+- `shrug`, `fu`, `facepalm`, `rock`, `bugeyes`, `dogshrug`, `yuno`
 
 ## Library Usage
 
-You can also use the gem programmatically:
+### Poop Emotes
+
+You can also use the gem programmatically:- `bullshit`, `catshit`, `dogshit`, `pandashit`, `horseshit`, `koalashit`, `batshit`
+
+
+
+```ruby### Keyboard Symbols
+
+require 'rage_flip'- `cmd`/`command` (⌘), `optn`/`option` (⌥), `cntl` (⌃), `shft`/`shift` (⇧), `cmd-` (⌘-)
+
 
-```ruby
-require 'rage_flip'
 
-# Flip text with rage emoticons
-RageFlip::Flipper.rage_flip("Hello World")
+# Flip text with rage emoticons### Special Characters
+
+RageFlip::Flipper.rage_flip("Hello World")- `noevil` (🙈🙉🙊), `omw` ("On my way!"), `heresatable`, `kungfuhamster` (ASCII art), `unsee`
+
 # => "(ノಠ益ಠ)ノ彡┻plɹoM ollǝH┻"
 
+Use `emote list` to see all available emotes with their outputs.
+
+# Flip text with classic table flip emoticons  
+
+RageFlip::Flipper.table_flip("Hello World")## Persistent Settings
+
+# => "(╯°□°)╯︵ plɹoM ollǝH ┻━┻"
+
+- **Chaos Level**: Stored in `~/.chaos_level.txt` and controls the intensity of the chaos effect (default: 10). This setting persists across terminal sessions and system reboots.
+
 # Just flip without emoticons
-RageFlip::Flipper.flip("Hello")
+
+RageFlip::Flipper.flip("Hello")## Library Usage
+
 # => "ollǝH"
 
-# Sarcastic text
-RageFlip::Sarcasm.process("hello world")
+You can also use the gem programmatically:
+
+# Flip text (same as flip)
+
+RageFlip::Flipper.flip_text("Hello")```ruby
+
+# => "ollǝH"require 'rage_flip'
+
+
+
+# Sarcastic text# Flip text with rage emoticons
+
+RageFlip::Sarcasm.process("hello world")RageFlip::Flipper.rage_flip("Hello World")
+
+# => "HeLlO WoRlD"# => "(ノಠ益ಠ)ノ彡┻plɹoM ollǝH┻"
+
+
+
+# Strikethrough# Flip text with classic table flip emoticons  
+
+RageFlip::Strikethrough.process("text")RageFlip::Flipper.table_flip("Hello World")
+
+# => "t̶e̶x̶t̶"# => "(╯°□°)╯︵ plɹoM ollǝH ┻━┻"
+
+
+
+# Underline (single or double)# Just flip without emoticons
+
+RageFlip::Underline.single_underline("text")RageFlip::Flipper.flip("Hello")
+
+# => "t̲e̲x̲t̲"# => "ollǝH"
+
+
+
+RageFlip::Underline.double_underline("text")# Flip text (same as flip)
+
+# => "t̳e̳x̳t̳"RageFlip::Flipper.flip_text("Hello")
+
+# => "ollǝH"
+
+# Chaos
+
+RageFlip::Chaos.process("text", 5)# Sarcastic text
+
+# => "t̸e̷x̸t̷"RageFlip::Sarcasm.process("hello world")
+
 # => "HeLlO WoRlD"
 
-# Strikethrough
-RageFlip::Strikethrough.process("text")
+# Emotes
+
+RageFlip::Emote.process("disapproval")# Strikethrough
+
+# => "(ಠ_ಠ)"RageFlip::Strikethrough.process("text")
+
 # => "t̶e̶x̶t̶"
 
-# Underline (single or double)
+RageFlip::Emote.process("bullshit")
+
+# => "🐄💩"# Underline (single or double)
+
 RageFlip::Underline.single_underline("text")
-# => "t̲e̲x̲t̲"
+
+RageFlip::Emote.process("cmd")# => "t̲e̲x̲t̲"
+
+# => "⌘"
 
 RageFlip::Underline.double_underline("text")
-# => "t̳e̳x̳t̳"
+
+RageFlip::Emote.process("shrug")# => "t̳e̳x̳t̳"
+
+# => "¯\_(ツ)_/¯"
 
 # Chaos
-RageFlip::Chaos.process("text", 5)
-# => "t̸e̷x̸t̷"
 
-# Copy to clipboard
+RageFlip::Emote.list_emotesRageFlip::Chaos.process("text", 5)
+
+# => "Available emotes:\n  batshit      - 🦇💩\n  bugeyes      - (⊙_◎)\n  bullshit     - 🐄💩\n..."# => "t̸e̷x̸t̷"
+
+
+
+# Check if emote exists# Emotes
+
+RageFlip::Emote.emote_exists?("rage")RageFlip::Emote.process("disapproval")
+
+# => true# => "(ಠ_ಠ)"
+
+
+
+# Get all emote namesRageFlip::Emote.process("bullshit")
+
+RageFlip::Emote.emote_names# => "🐄💩"
+
+# => ["disapproval", "bullshit", "catshit", ...]
+
+RageFlip::Emote.process("cmd")
+
+# Copy to clipboard# => "⌘"
+
 RageFlip::Clipboard.copy("text to copy")
-```
+
+```RageFlip::Emote.process("shrug")
+
+# => "¯\_(ツ)_/¯"
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
+RageFlip::Emote.list_emotes
 
-### Version Management
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.# => "Available emotes:\n  batshit      - 🦇💩\n  bugeyes      - (⊙_◎)\n  bullshit     - 🐄💩\n..."
 
-The gem includes comprehensive version management tools:
 
-#### Rake Tasks
 
-```bash
+### Version Management# Check if emote exists
+
+RageFlip::Emote.emote_exists?("rage")
+
+The gem includes comprehensive version management tools:# => true
+
+
+
+#### Rake Tasks# Get all emote names
+
+RageFlip::Emote.emote_names
+
+```bash# => ["disapproval", "bullshit", "catshit", ...]
+
 # Show current version
-rake version:show
 
-# Bump patch version (1.0.0 -> 1.0.1)
+rake version:show# Copy to clipboard
+
+RageFlip::Clipboard.copy("text to copy")
+
+# Bump patch version (1.0.0 -> 1.0.1)```
+
 rake version:bump:patch
 
+## Development
+
 # Bump minor version (1.0.0 -> 1.1.0)  
-rake version:bump:minor
 
-# Bump major version (1.0.0 -> 2.0.0)
+rake version:bump:minorAfter checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
+
+
+
+# Bump major version (1.0.0 -> 2.0.0)### Version Management
+
 rake version:bump:major
 
+The gem includes comprehensive version management tools:
+
 # Set specific version
-rake version:set[1.2.3]
+
+rake version:set[1.2.3]#### Rake Tasks
+
 ```
 
-#### Version Script
+```bash
+
+#### Version Script# Show current version
+
+rake version:show
 
 ```bash
-# Show current version
-./bin/version show
 
-# Bump versions
-./bin/version patch
+# Show current version# Bump patch version (1.0.0 -> 1.0.1)
+
+./bin/version showrake version:bump:patch
+
+
+
+# Bump versions# Bump minor version (1.0.0 -> 1.1.0)  
+
+./bin/version patchrake version:bump:minor
+
 ./bin/version minor  
-./bin/version major
+
+./bin/version major# Bump major version (1.0.0 -> 2.0.0)
+
+rake version:bump:major
 
 # Set specific version
-./bin/version set 1.2.3
+
+./bin/version set 1.2.3# Set specific version
+
+```rake version:set[1.2.3]
+
 ```
 
 #### Release Process
 
+#### Version Script
+
 ```bash
-# Complete release workflow
+
+# Complete release workflow```bash
+
+rake release# Show current version
+
+# This will: run tests, build gem, create git tag./bin/version show
+
+```
+
+# Bump versions
+
+### Automated CI/CD./bin/version patch
+
+./bin/version minor  
+
+The project includes GitHub Actions workflows for:./bin/version major
+
+- **Continuous Integration**: Runs tests on Ruby 3.0, 3.1, and 3.2
+
+- **Automated Releases**: Creates GitHub releases when commits start with "Release v"# Set specific version
+
+./bin/version set 1.2.3
+
+To create a release:```
+
+1. Bump the version: `./bin/version minor`
+
+2. Update CHANGELOG.md with changes#### Release Process
+
+3. Commit: `git commit -am "Release v1.1.0"`  
+
+4. Push: `git push origin main````bash
+
+5. The CI will automatically create a GitHub release with the built gem# Complete release workflow
+
 rake release
-# This will: run tests, build gem, create git tag
+
+## Contributing# This will: run tests, build gem, create git tag
+
 ```
 
+Bug reports and pull requests are welcome on GitHub at https://github.com/stringsn88keys/rage_flip_gem.
+
 ### Automated CI/CD
 
+## License
+
 The project includes GitHub Actions workflows for:
-- **Continuous Integration**: Runs tests on Ruby 3.0, 3.1, and 3.2
+
+The gem is available as open source under the terms of the MIT License.- **Continuous Integration**: Runs tests on Ruby 3.0, 3.1, and 3.2
 - **Automated Releases**: Creates GitHub releases when commits start with "Release v"
 
 To create a release: