docs: document schema fields

Author: robjtede

.vscode/settings.json

@@ -24,6 +24,8 @@
         "strs",
         "struct",
         "structs",
+        "subschema",
+        "subschemas",
         "valtree",
         "valtrees"
     ],

Cargo.toml

@@ -13,7 +13,6 @@ rust_2018_idioms = "deny"
 nonstandard_style = "deny"
 future_incompatible = "deny"
 missing_debug_implementations = { level = "warn", priority = -1 }
-missing_docs = { level = "warn", priority = -1 }
 
 [workspace.dependencies]
 assert_matches = "1"

crates/oas3/CHANGELOG.md

@@ -2,8 +2,12 @@
 
 ## Unreleased
 
+- Add `spec::ObjectSchema::deprecated` field.
+- Add `spec::ObjectSchema::examples` field.
 - Add `spec::Contact::validate_email()` method.
 - Expose the `spec::ClientCredentialsFlow::token_url` field.
+- The type of the `spec::ObjectSchema::enum` field is now `Vec<serde_json::Value>`.
+- The type of the `spec::ObjectSchema::const` field is now `Option<serde_json::Value>`.
 - Rename `Error::{SemVerError => Semver}` enum variant.
 - Rename `spec::RefError::{InvalidType => UnknownType}` enum variant.
 

crates/oas3/src/lib.rs

@@ -14,6 +14,7 @@
 //!
 //! [OpenAPI v3.1]: https://github.com/OAI/OpenAPI-Specification/blob/HEAD/versions/3.1.0.md
 
+#![warn(missing_docs)]
 #![cfg_attr(docsrs, feature(doc_auto_cfg))]
 
 use std::{fs::File, io::Read, path::Path};