docs: Dedicated examples/

Files in `examples/` will be compiled by `cargo
test`. Hence, uncompilable code will be caught
from now on.

One can `cargo run --example simple` to see the
`println!` output. This allows users to get
started hacking quickly.

Author: alexpovel

README.md

@@ -8,22 +8,9 @@ It fully supports the relevant [Unicode Technical Standard](https://www.unicode.
 
 ### Usage
 
-Here is an example illustrating a common usage:
-
-```Rust
-use ada_url::Url;
-fn main() -> Result<(), Box<dyn std::error::Error>> {
-    let mut u = Url::parse("http://www.google:8080/love#drug", None).expect("bad url");
-    println!("port: {:?}", u.port());
-    println!("hash: {:?}", u.hash());
-    println!("pathname: {:?}", u.pathname());
-    println!("href: {:?}", u.href());
-    u.set_port(Some("9999"))?;
-    println!("href: {:?}", u.href());
-
-    Ok(())
-}
-```
+See [here](examples/simple.rs) for a usage example.
+You can run it locally with `cargo run --example simple`.
+Feel free to adjust it for exploring this crate further.
 
 #### Features
 

examples/simple.rs

@@ -0,0 +1,13 @@
+use ada_url::Url;
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let mut u = Url::parse("http://www.google:8080/love#drug", None).expect("bad url");
+    println!("port: {:?}", u.port());
+    println!("hash: {:?}", u.hash());
+    println!("pathname: {:?}", u.pathname());
+    println!("href: {:?}", u.href());
+    u.set_port(Some("9999"))?;
+    println!("href: {:?}", u.href());
+
+    Ok(())
+}