diff --git a/docs/blocks/index.md b/docs/blocks/index.md
index 54e7a094d..911236104 100644
--- a/docs/blocks/index.md
+++ b/docs/blocks/index.md
@@ -94,7 +94,7 @@ If you want to make a block that has different variants (think a slab that has a
 
 ### `DeferredRegister.Blocks` helpers
 
-We already discussed how to create a `DeferredRegister.Blocks`, and that it returns `DeferredBlock`s. Now, let's have a look at what other utilities the specialized `DeferredRegister` has to offer. Let's start with `#registerBlock`:
+We already discussed how to create a `DeferredRegister.Blocks` [above], as well as that it returns `DeferredBlock`s. Now, let's have a look at what other utilities the specialized `DeferredRegister` has to offer. Let's start with `#registerBlock`:
 
 ```java
 public static final DeferredRegister.Blocks BLOCKS = DeferredRegister.createBlocks("yourmodid");
diff --git a/docs/concepts/registries.md b/docs/concepts/registries.md
index 29fc1ed0b..448cddf3f 100644
--- a/docs/concepts/registries.md
+++ b/docs/concepts/registries.md
@@ -66,6 +66,7 @@ Finally, since the entire system is a wrapper around registry events, we need to
 ```java
 //This is our mod constructor
 public ExampleMod(IModEventBus bus) {
+    //highlight-next-line
     ExampleBlocksClass.BLOCKS.register(bus);
     //Other stuff here
 }
@@ -109,7 +110,7 @@ public static final ResourceKey<Registry<Spell>> SPELL_REGISTRY_KEY = ResourceKe
 public static final Registry<YourRegistryContents> SPELL_REGISTRY = new RegistryBuilder<>(SPELL_REGISTRY_KEY)
         // If you want the registry to sync its values.
         .sync(true)
-        // The default key. Similar to minecraft:air for blocks.
+        // The default key. Similar to minecraft:air for blocks. This is optional.
         .defaultKey(new ResourceLocation("yourmodid", "empty"))
         // Effectively limits the max count. Generally discouraged, but may make sense in settings such as networking.
         .maxId(256)