Add examples to docs

docs/examples/1-derive_jsonschema.md

@@ -0,0 +1,13 @@
+---
+layout: default
+title: Deriving JsonSchema
+parent: Examples
+nav_order: 1
+summary: Deriving JsonSchema on a struct and enum.
+---
+
+# Deriving JsonSchema
+
+This is the simplest usage of Schemars. Both types are made to derive `JsonSchema`, and the `schema_for!` macro is used to generate the schema itself.
+
+{% include example.md name="main" %}

docs/examples/2-serde_attrs.md

@@ -0,0 +1,15 @@
+---
+layout: default
+title: Using Serde Attributes
+parent: Examples
+nav_order: 2
+summary: 'Deriving JsonSchema on types that use #[serde] attributes to customise serialization behaviour.'
+---
+
+# Using Serde Attributes
+
+One of the main aims of this library is compatibility with [Serde](https://github.com/serde-rs/serde). Any generated schema *should* match how [serde_json](https://github.com/serde-rs/json) would serialize/deserialize to/from JSON. To support this, Schemars will check for any `#[serde(...)]` attributes on types that derive `JsonSchema`, and adjust the generated schema accordingly.
+
+The list of supported `#[serde]` attributes are [documented here]({{ site.baseurl }}/deriving/attributes/#supported-serde-attributes).
+
+{% include example.md name="serde_attrs" %}

docs/examples/example1.md

@@ -1,9 +0,0 @@
----
-layout: default
-title: Example 1
-parent: Examples
-nav_order: 1
-summary: blah blah blahhh
----
-
-# Examples 1: A Meta-Example

docs/examples/example2.md

@@ -1,8 +0,0 @@
----
-layout: default
-title: Example 2
-parent: Examples
-nav_order: 2
----
-
-# Examples 2: Another Meta-Example