diff --git a/r/sql_database_instance.html.markdown b/r/sql_database_instance.html.markdown
index 7eab5f1f..3d235163 100644
--- a/r/sql_database_instance.html.markdown
+++ b/r/sql_database_instance.html.markdown
@@ -38,7 +38,10 @@ The following arguments are supported:
- - -
* `database_version` - (Optional, Default: `MYSQL_5_6`) The MySQL version to
- use. Can be either `MYSQL_5_5` or `MYSQL_5_6`.
+ use. Can be either `MYSQL_5_6` or `MYSQL_5_7` for second-generation
+ instances, or `MYSQL_5_5` or `MYSQL_5_6` for first-generation instances.
+ See Google's [Second Generation Capabilities](https://cloud.google.com/sql/docs/1st-2nd-gen-differences)
+ for more information.
* `name` - (Optional, Computed) The name of the instance. If the name is left
blank, Terraform will randomly generate one when the instance is first