docs: Updates main and book README.md files. (#131)

* docs: Updates main and book README.md files.

* Fixed spelling errors.

Author: lukasfri

README.md

@@ -8,14 +8,15 @@
 [docs.rs]: https://docs.rs/xmlity/latest/xmlity/
 [xmlity msrv]: https://img.shields.io/badge/rustc-1.82.0+-ab6000.svg
 [Rust 1.82]: https://blog.rust-lang.org/2023/06/01/Rust-1.82.0.html
+[examples]: ./xmlity-quick-xml/examples/
 
-XMLity is a (de)serialization library for XML, inspired by [Serde](https://serde.rs/) and improves upon XML (de)serialization libraries such as [yaserde](https://github.com/media-io/yaserde) and [quick-xml](https://github.com/tafia/quick-xml) by providing a more flexible API that is more powerful, utilising primairly a trial and error approach to parsing XML. This can inherently be a bit slower than other libraries, but it allows for more complex XML structures to be parsed.
+XMLity is a (de)serialization library for XML, inspired by [Serde](https://serde.rs/) and improves upon XML (de)serialization libraries such as [yaserde](https://github.com/media-io/yaserde) and [quick-xml](https://github.com/tafia/quick-xml) by providing a more flexible API that is more powerful, utilising primarily a trial and error approach to parsing XML. This can inherently be a bit slower than other libraries, but it allows for more complex XML structures to be parsed.
 
 ---
 
 ## Get started
 
-To get started, we recommend you check out the [XMLity book](https://xmlity.lukasfri.com) and [the documentation][docs.rs].
+To get started, we recommend you check out [the documentation][docs.rs] and [the examples][examples].
 
 ## Example
 
@@ -64,6 +65,16 @@ assert_eq!(person.name.0, "John");
 assert_eq!(person.age.0, 42);
 ```
 
+## Why use XMLity instead of other XML libraries?
+
+- `serde-xml-rs`: Lacking proper namespace support and other features.
+- `yaserde`: Lacking support for trial-and-error deserialization, a requirement for full coverage of XML schemas.
+- `quick-xml`(`serde` feature): Lacking support for namespaces.
+
+## Other resources
+
+- **The official XML schema generator**: Coming soon! It's already very feature-rich and is good enough to bootstrap itself by deserializing XML schemas using its own generated code, however it still requires some cleanup before its ready for public use.
+
 ## License
 
 <sup>

xmlity-book/README.md

@@ -0,0 +1,3 @@
+# The XMLity Book
+
+This book is not finished and not up to date. Do not use it, refer to the documentation at [docs.rs](https://docs.rs/xmlity/latest/xmlity/) instead.