docs: update

Author: cijiugechu

Cargo.toml

@@ -22,6 +22,7 @@ serde = { version = "1.0.190", features = ["derive"], optional = true }
 pretty_assertions = "1.4.0"
 criterion         = {  version = "0.5.1", features = ["html_reports"] }
 serde_json        = "1.0"
+serde = { version = "1.0.190", features = ["derive"] }
 
 [features]
 default = []
@@ -30,3 +31,8 @@ serde = ["dep:serde"]
 [[bench]]
 name = "parser"
 harness = false
+
+[[example]]
+name = "serde"
+path = "examples/serde.rs"
+required-features = ["serde"]

README.md

@@ -26,3 +26,9 @@ let range: Range = "^1.2".parse().unwrap();
 
 assert!(version.satisfies(&range));
 ```
+
+## Optional Features
+
+The following are a list of [Cargo features](https://doc.rust-lang.org/stable/cargo/reference/features.html#the-features-section) that can be enabled:
+
+- **serde**: Provides serialization and deserialization for [Version] and [Range]. 

examples/serde.rs

@@ -0,0 +1,18 @@
+use nodejs_semver::Version;
+use serde::Serialize;
+
+#[derive(Serialize)]
+struct MyVersion {
+    version: Version,
+    info: String,
+}
+
+fn main() {
+    let v = "3.4.5-rc.1".parse::<Version>().unwrap();
+    let my_version = MyVersion {
+        version: v,
+        info: "info".to_string(),
+    };
+
+    println!("{}", serde_json::to_string(&my_version).unwrap());
+}