docs: improve docs with ice cream machine instead of ice machines (#7)

* docs: improve docs with ice cream machine instead of ice machines

- Resolve very important distinction of "ice machines" vs "ice cream" machines.
- Ensure users are aware of the key infrastructure difference between ice-cream and ice machines.

* docs: spelling fixes

Author: sheldonhull

README.md

@@ -5,7 +5,7 @@
 ![GitHub release (latest by date)](https://img.shields.io/github/v/release/circa10a/terraform-provider-mcbroken?style=plastic)
 [![Buy Me A Coffee](https://img.shields.io/badge/BuyMeACoffee-Donate-ff813f.svg?logo=CoffeeScript&style=plastic)](https://www.buymeacoffee.com/caleblemoine)
 
-Base the count of your infrastucture resources on the current number of broken mcdonald's ice machines nationally or by a city of your choosing. Powered by [Mcbroken](https://mcbroken.com/).
+Base the count of your infrastructure resources on the current number of broken mcdonald's ice cream machines nationally or by a city of your choosing. Powered by [Mcbroken](https://mcbroken.com/).
 
 - [terraform-provider-mcbroken](#terraform-provider-mcbroken)
   * [Usage](#usage)
@@ -166,3 +166,13 @@ terraform apply
 ### Windows
 
 ![alt text](https://media.giphy.com/media/4cuyucPeVWbNS/giphy.gif)
+
+
+## FAQ
+
+### Is this based on ice cream machines or ice machines? What is the difference?
+
+This is based on ice cream machines, not ice machines.
+Ice machines produce ice for drinks, while ice cream machines produce frozen milk product based treats.
+
+Please don't use this project to rely on _ice machines_ or your results will be incorrect.

docs/data-sources/cities.md

@@ -24,5 +24,5 @@ None
 
 ## Attribute Reference
 
-* `cities` - List of maps that contains cities and their broken ice machine average
+* `cities` - List of maps that contains cities and their broken ice cream machine average
 * `broken` - National average of broken ice cream machines

docs/index.md

@@ -1,6 +1,6 @@
 # Mcbroken Provider
 
-Base the count of your infrastucture resources on the current number of broken mcdonald's ice machines nationally or by a city of your choosing. Powered by [Mcbroken](https://mcbroken.com/).
+Base the count of your infrastructure resources on the current number of broken mcdonald's ice cream machines nationally or by a city of your choosing. Powered by [Mcbroken](https://mcbroken.com/).
 
 ## Example Usage
 
@@ -52,3 +52,13 @@ output "user_specified_city_not_found" {
 ## Argument Reference
 
 * `url` - Mcbroken JSON endpoint
+
+
+## FAQ
+
+### Is this based on ice cream machines or ice machines? What is the difference?
+
+This is based on ice cream machines, not ice machines.
+Ice machines produce ice for drinks, while ice cream machines produce frozen milk product based treats.
+
+Please don't use this project to rely on _ice machines_ or your results will be incorrect.