make some fixes from suggestions in Slack

Author: gregsdennis

_docs/schema/examples/custom-vocabs.md

@@ -42,7 +42,7 @@ public class MaxDateKeyword : IJsonSchemaKeyword
 
     // Implements IJsonSchemaKeyword
     public KeywordConstraint GetConstraint(SchemaConstraint schemaConstraint,
-        IReadOnlyList<KeywordConstraint> localConstraints,
+        ReadOnlySpan<KeywordConstraint> localConstraints,
         EvaluationContext context)
     {
         throw new NotImplementedException();
@@ -165,9 +165,9 @@ Then they need to be registered.  This is done on the schema validation options.
 options.SchemaRegistry.Register(new Uri("http://mydates.com/vocab/schema"), DatesMetaSchema);
 options.SchemaRegistry.Register(new Uri("http://mydates.com/dialect/schema"), DatesDialectMetaSchema);
 
-// Register the vocabulary.  This automatically registers the keywords
-// defined by the vocabulary.
-options.VocabularyRegistry.Register(DatesVocabulary);
+// Register the vocabulary.
+// You'll still need to register the keywords as shown in the previous section.
+VocabularyRegistry.Register(DatesVocabulary);
 ```
 
 And that's it.  The vocabulary and keyword are ready for use.

_docs/schema/schemagen/examples/attribute.md

@@ -6,7 +6,7 @@ permalink: /schema/examples/:title/
 icon: fas fa-tag
 order: "01.5.4.3"
 ---
-In the [previous example](schema-gen-intent.md) we created a keyword intent to represent a new `maxDate` keyword during generation.
+In the [previous example](schema-gen-intent.md) we created a keyword intent to represent the [`maxDate` keyword](/schema/examples/custom-vocabs/#example-schema-vocabs-keyword) during generation.
 
 Now we need a way to add it into the generation.  This keyword is a validation constraint that you might expect to see as an attribute, so we'll do that.
 
@@ -26,7 +26,7 @@ public class MaxDateAttribute : Attribute, IAttributeHandler
     }
 
     // It's not necessary to implement this explicitly, but I like to.
-    void IAttributeHandler.AddConstraints(SchemaGeneratorContext context)
+    void IAttributeHandler.AddConstraints(SchemaGeneratorContextBase context)
     {
         var attribute = context.Attributes.OfType<MaxDateAttribute>()
                                           .FirstOrDefault();

_docs/schema/schemagen/examples/generator.md

@@ -21,7 +21,7 @@ class TimeSpanSchemaGenerator : ISchemaGenerator
         return type == typeof(TimeSpan);
     }
 
-    public void AddConstraints(SchemaGeneratorContext context)
+    public void AddConstraints(SchemaGeneratorContextBase context)
     {
         context.Intents.Add(new TypeIntent(SchemaValueType.String));
         context.Intents.Add(new FormatIntent(Formats.Duration));

_docs/schema/schemagen/examples/intent.md

@@ -8,7 +8,7 @@ order: "01.5.4.2"
 ---
 This example shows how to extend schema generation to output a new keyword.
 
-Suppose we've implemented the `maxDate` keyword (see the "Custom Vocabularies" example).  Now we need a way to generate schemas that contain it.
+Suppose we've implemented the `maxDate` keyword from the [Custom Vocabularies example](/schema/examples/custom-vocabs/#example-schema-vocabs-keyword).  Now we need a way to generate schemas that contain it.
 
 For this we need to create a _keyword intent_.
 

_docs/schema/schemagen/examples/refiner.md

@@ -19,13 +19,13 @@ It first looks at the generated schema to determine whether it can add a `null`
 ```c#
 internal class NullabilityRefiner : ISchemaRefiner
 {
-    public bool ShouldRun(SchemaGeneratorContext context)
+    public bool ShouldRun(SchemaGeneratorContextBase context)
     {
         // we only want to run this if the generated schema has a `type` keyword
         return context.Intents.OfType<TypeIntent>().Any();
     }
 
-    public void Run(SchemaGeneratorContext context)
+    public void Run(SchemaGeneratorContextBase context)
     {
         // find the type keyword
         var typeIntent = context.Intents.OfType<TypeIntent>().Firs();

_docs/schema/schemagen/schema-generation.md

@@ -6,7 +6,7 @@ permalink: /schema/schemagen/:title/
 icon: fas fa-tag
 order: "01.5.1"
 ---
-*JsonSchema.Net.Generation* is an extension package to *JsonSchema.Net* that provides JSON Schema generation from .Net types.
+_JsonSchema.Net.Generation_ is an extension package to _JsonSchema.Net_ that provides JSON Schema generation from .Net types.
 
 Using it is quite simple.  First you need a `JsonSchemaBuilder`.  Then...
 
@@ -368,7 +368,7 @@ public class MaximumAttribute : Attribute, IAttributeHandler<MaximumAttribute>
         Value = value;
     }
 
-    void IAttributeHandler.AddConstraints(SchemaGeneratorContext context)
+    void IAttributeHandler.AddConstraints(SchemaGeneratorContextBase context)
     {
         if (!context.Type.IsNumber()) return;