Add docs permalinks

docs/1-deriving.md

@@ -4,6 +4,7 @@ title: Deriving JsonSchema
 nav_order: 2
 has_children: true
 has_toc: false
+permalink: /deriving
 ---
 
 # Deriving JsonSchema

docs/1.1-attributes.md

@@ -3,6 +3,7 @@ layout: default
 title: Attributes
 parent: Deriving JsonSchema
 nav_order: 1
+permalink: /deriving/attributes
 ---
 
 <style>
@@ -40,7 +41,7 @@ Serde also allows setting `#[serde(...)]` attributes which change how types are
 `#[serde(rename = "name")]` / `#[schemars(rename = "name")]`
 </h3>
 
-Set on a struct, enum, field or variant to use the given name in the generated schema instead of the Rust name. When used on a struct or enum, the given name will be used as the title for root schemas, and as the schema identifier for schemas referenced from another schema's `$ref` property.
+Set on a struct, enum, field or variant to use the given name in the generated schema instead of the Rust name. When used on a struct or enum, the given name will be used as the title for root schemas, and the key within the root's `definitions` property for subschemas.
 
 If set on a struct or enum with generic type parameters, then the given name may contain them enclosed in curly braces (e.g. `{T}`) and they will be replaced with the concrete type names when the schema is generated.
 

docs/2-implementing.md

@@ -2,6 +2,7 @@
 layout: default
 title: Implementing JsonSchema
 nav_order: 3
+permalink: /implementing
 ---
 
 # Implementing JsonSchema

docs/3-generating.md

@@ -2,6 +2,7 @@
 layout: default
 title: Generating Schemas
 nav_order: 4
+permalink: /generating
 ---
 
 # Generating Schemas

docs/4-features.md

@@ -2,6 +2,7 @@
 layout: default
 title: Feature Flags
 nav_order: 5
+permalink: /features
 ---
 
 # Feature Flags and Optional Dependencies

docs/404.html

@@ -1,5 +1,5 @@
 ---
-permalink: /404.html
+permalink: /404
 layout: default
 nav_exclude: true
 ---

docs/5-examples.md

@@ -3,6 +3,7 @@ layout: default
 title: Examples
 nav_order: 6
 has_children: true
+permalink: /examples
 ---
 
 # Examples

schemars/src/lib.rs

@@ -231,7 +231,7 @@ pub trait JsonSchema {
 
     /// The name of the generated JSON Schema.
     ///
-    /// This is used as the title for root schemas, and the key within the `definitions` property for subschemas.
+    /// This is used as the title for root schemas, and the key within the root's `definitions` property for subschemas.
     fn schema_name() -> String;
 
     /// Generates a JSON Schema for this type.