Update scalar docs (#1265)

* Update scalar docs

* Update scalars.md

Author: smyrick

website/docs/schema-generator/writing-schemas/scalars.md

@@ -9,14 +9,19 @@ extended scalar types provided by `graphql-java`.
 
 | Kotlin Type             | GraphQL Type     |
 | ----------------------- | ---------------- |
-| `kotlin.Int`     | `Int`     |
-| `kotlin.Float`   | `Float`   |
-| `kotlin.String`  | `String`  |
-| `kotlin.Boolean` | `Boolean` |
+| `kotlin.String`   | `String`  |
+| `kotlin.Boolean`  | `Boolean` |
+| `kotlin.Int`      | `Int`     |
+| `kotlin.Double`   | `Float`   |
+| `kotlin.Float`    | `Float`   |
+
+:::note
+The GraphQL spec uses the term `Float` for signed double‐precision fractional values. `graphql-java` maps this to a `java.lang.Double` for the execution. The generator will map both `kotlin.Double` and `kotlin.Float` to GraphQL `Float` but we reccomend you use `kotlin.Double`
+:::
 
 :::caution
 Extended GraphQL scalar types provided by `graphql-java` were [deprecated in v15](https://github.com/graphql-java/graphql-java/releases/tag/v15.0).
-This includes the following types: `Double`, `Long`, `Short`, `Float`, `BigInteger`, `BigDecimal`, and `Char`. If you are currently
+This includes the following types: `Long`, `Short`, `BigInteger`, `BigDecimal`, and `Char`. If you are currently
 using these types, they will be removed in future `graphql-java` releases.
 
 See the [graphql-java-extended-scalars](https://github.com/graphql-java/graphql-java-extended-scalars) project if you need continued support.

website/versioned_docs/version-4.x.x/schema-generator/writing-schemas/scalars.md

@@ -9,14 +9,19 @@ extended scalar types provided by `graphql-java`.
 
 | Kotlin Type             | GraphQL Type     |
 | ----------------------- | ---------------- |
-| `kotlin.Int`     | `Int`     |
-| `kotlin.Float`   | `Float`   |
-| `kotlin.String`  | `String`  |
-| `kotlin.Boolean` | `Boolean` |
+| `kotlin.String`   | `String`  |
+| `kotlin.Boolean`  | `Boolean` |
+| `kotlin.Int`      | `Int`     |
+| `kotlin.Double`   | `Float`   |
+| `kotlin.Float`    | `Float`   |
+
+:::note
+The GraphQL spec uses the term `Float` for signed double‐precision fractional values. `graphql-java` maps this to a `java.lang.Double` for the execution. The generator will map both `kotlin.Double` and `kotlin.Float` to GraphQL `Float` but we reccomend you use `kotlin.Double`
+:::
 
 :::caution
 Extended GraphQL scalar types provided by `graphql-java` were [deprecated in v15](https://github.com/graphql-java/graphql-java/releases/tag/v15.0).
-This includes the following types: `Double`, `Long`, `Short`, `Float`, `BigInteger`, `BigDecimal`, and `Char`. If you are currently
+This includes the following types: `Long`, `Short`, `BigInteger`, `BigDecimal`, and `Char`. If you are currently
 using these types, they will be removed in future `graphql-java` releases.
 
 See the [graphql-java-extended-scalars](https://github.com/graphql-java/graphql-java-extended-scalars) project if you need continued support.