Skip to content

Commit 63112c6

Browse files
committed
add note about numeric support on schema docs
1 parent 5e57447 commit 63112c6

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

_docs/schema/basics.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,9 @@ The JSON Schema team recommends using draft 7 or later. *JsonSchema.Net* suppor
2929
> The next version of JSON Schema, which is supported by v4.0.0 and later of this library, is currently in development and will start a new era for the project which includes various backward- and forward-compatibility guarantees. Have a read of the various discussions happening in the [JSON Schema GitHub org](https://github.com/json-schema-org) for more information.
3030
{: .prompt-tip }
3131

32+
> This library uses [`decimal`](https://learn.microsoft.com/en-us/dotnet/api/system.decimal?view=net-8.0) for floating point number representation. While `double` (and even `float`) may support a larger range, the higher precision of `decimal` is often more important (for example, in financial applications). This also aligns with [JSON](https://datatracker.ietf.org/doc/html/rfc8259#section-6) itself, which uses arbitrary-precision numbers. [This site](https://www.geeksforgeeks.org/difference-between-decimal-float-and-double-in-net/) has a good summary of the differences between the numeric types.
33+
{: .prompt-warning }
34+
3235
### Meta-schemas {#schema-metaschemas}
3336

3437
Each version defines a meta-schema. This is a special JSON Schema that describes all of the keywords available for that version. They are intended to be used to validate other schemas. Usually, a schema will declare the version it should adhere to using the `$schema` keyword.
@@ -193,8 +196,7 @@ builder.Properties(
193196

194197
# Evaluation & annotations {#schema-evaluation}
195198

196-
> In recognizing the multitude of uses for JSON Schema, the team has started to use the word "evaluate" instead of "validate" for the general processing of a schema. What was "validate" in v3.x of this library is now "evaluate" in order to align with this viewpoint.
197-
{: .prompt-info }
199+
Among the myriad of uses for JSON Schema, _JsonSchema.Net_ is considered a "validator". That is, it evaluates schemas against a data instance and produces a validation result and annotations.
198200

199201
## Evaluating instances {#schema-evaluation-2}
200202

0 commit comments

Comments
 (0)