README.md in medieval_latina-2.1.1 vs README.md in medieval_latina-3.0.0

@@ -19,16 +19,61 @@
 
     $ gem install medieval_latina
 
 ## Usage
 
+### Help English language text-to-speech engines pronounce Latin
 ```ruby
 ["caelum", "omnia", "pugno"].each { |word| puts MedievalLatina[word] }
 => "chayloom"
 => "ohm-nia"
 => "poon-yoh"
 
+sentence = MedievalLatina["sed libera nos a malo"]
+=> "sayd leebayrah nohs ah mahloh"
+```
+```javascript
+let sentence = "...";
+responsiveVoice.speak(sentence, "UK English Female");
+```
+### Generate lexicons to override text-to-speech pronunciation
+```ruby
+polly = Aws::Polly::Client.new
+s3 = Aws::S3::Client.new
+
+sentence = "PATER NOSTER qui es in caelis"
+
+words = sentence.split(" ")
+pronunciations = MedievalLatina.pronunciations_for(words)
+lexicon = MedievalLatina::LexiconBuilder.new(pronunciations).call
+
+name = "CustomLatin"
+polly.put_lexicon(name: name, content: lexicon.to_s)
+
+# Synthesize speech using the lexicons
+response = polly.synthesize_speech(
+  lexicon_names: [name],
+  text: sentence,
+  output_format: "mp3",
+  voice_id: "Joanna"
+)
+
+# Read the audio data and store it in a variable
+audio_data = response.audio_stream.read
+
+bucket_name = "foo"
+object_key = "bar/pater-noster.mp3"
+
+s3.put_object(
+  bucket: bucket_name,
+  key: object_key,
+  body: audio_data
+)
+```
+
+### Latin langauge helper methods
+```ruby
 MedievalLatina.verb?("voco")
 => true
 
 MedievalLatina.verb?("nauta")
 => false
@@ -46,18 +91,19 @@
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies.
 Then, run `rake spec` to run the tests.
 You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+Maintain project style by running `bin/lint` before commiting changes.
 
 To install this gem onto your local machine, run `bundle exec rake install`.
 
 To release a new version:
 1. Update the version number in `version.rb`
 2. Run `bin/setup` to increment the version in the lock file
 3. Run `bundle exec rake release`
 
-Rebuild the lexicon file when you add new International Phonetic Alphabet pronunciations.
+Rebuild the lexicon files when you add new International Phonetic Alphabet pronunciations.
 You do this by running: `bin/build`
 
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/jaysonvirissimo/medieval_latina.